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PREFACE 


This publication, when used with the program listings, enables you to understand the 
internal operation of the I/O supervisor and to makes changes to it when necessary. 


This publication does not replace the program listings; it supplements them and makes 
the information in them more accessible. This publication has the following sections: 


e “Introduction,” which contains information about the I/O supervisor’s services and 
overall operation. 


e ‘Method of Operation,” which contains diagrams that describe the operation of the 
I/O supervisor. The diagrams are high-level and are designed to guide you toa 
particular area of the program listing. 


e ‘Program Organization.” which contains a functional organization chart for each of 
the main functions of the I/O supervisor, and describes what each routine does. 


e ‘Directories,’’ which contains cross-reference lists that include a data area directory, 
module directory, and routine directory. 


e ‘Data Areas,’’ which contains descriptions of the interrelationship and content of data 
areas and control blocks that are used primarily by the I/O supervisor. 


e ‘Diagnostic Aids,’ which contains information to help you interpret the program 
listings and diagnose program failures. 


e “Appendix A: Supporting SVC Routines,” which contains information about 
supporting SVC routines. 


e “Appendix B: Alternate Path Retry,” which contains information about the alternate 
path selective retry option and its relationship to the I/O supervisor. 


e “Appendix C: Direct-Access Volume Verification,” which contains information about 
the direct-access volume verification option and its relationship to the I/O supervisor. 


e “Appendix D: Dynamic Device Reconfiguration,’ which contains information about 
the dynamic device reconfiguration option and its relationship to the I/O supervisor. 


e “Appendix E: Program Check Recovery Subroutine,’’ which contains information 
about the program check recovery subroutine. 


e ‘Appendix F: Shared Direct-Access Storage Device,” which contains information 
about the shared direct-access storage device option and its relationship to the I/O 
supervisor. 


e “Appendix G: I/O Supervisor—OLTEP Synchronizing Module (IECIOCTS),” which 
contains the requirements of the Online Test Executive Program for the I/O 
supervisor. 


e “Appendix H: Device-Dependent Error Routines,’’ which describes device-dependent 
error routines and contains information about writing error recovery messages to the 
operator. 


e “Glossary of Terms, Acronyms, and Abbreviations,” which contains definitions of 
terms used in this publication along with the meanings of the acronyms and 
abbreviations used. 
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How to Use This Publication 


Before using this publication, read the “Introduction” to establish perspective, and then 
at least scan the remainder of the publication to familiarize yourself with its content. This 
publication is primarily a reference manual because each section contains a specific type 
of information. You will be better able to service the program when you can refer quickly 
to the section containing the type of information you need. 


The “‘Method of Operation’’ section contains diagrams, each consisting of two pages. 
The first page (left or upper) is the actual diagram. The second page (right or lower) 
consists of expanded text and references to other diagrams and flowcharts. The diagrams 
are at a high level; therefore, some of the 1/O supervisor functions are not shown. The 
routine directory (see ‘“‘Directories’’ can be used to find entry points into the routines 
that are not included in the diagrams. 


Referenced System and Data Management Publications 


The following publications (listed in order-number order) are referenced throughout this 
publication: 


e OS/VS Recovery Management Logic, GC27-7239 

e OS/VS2 Planning and Use Guide, GC28-0600 

e OS/VS Data Management for System Programmers, GC28-0631 
e OS/VS2 Debugging Guide, GC28-0632 

e OS/VS Service Aids, GC28-0633 

e OS/VS Utilities, GC35-0005 

e OS/VS Message Library: VS2 System Messages, GC38-1002 
e OS/VS Message Library: VS2 System Codes, GC38-1008 

e OS/VS2 Supervisor Logic, SY27-7244 

e OS/VS2 System Data Areas, SY28-0606 

e OS/VS OLTEP Logic, SY28-0637 

e OS/VS SYSI.LOGREC Error Recording Logic, SY28-0639 


Other OS/VS publications are listed in the [BM System/360 and System/370 
Bibliography, GA22-6822. 
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INTRODUCTION 


Following execution of the statements or instructions written by programmers to cause 
I/O activity, a sequence of events begins in which the I/O supervisor plays a major role. 
This section defines that role and describes the environment in which it is performed. 


An I/O operation can be described as the sequence of events beginning with the 
execution of the statement or instruction a programmer writes to cause data to be written 
on or read from an I/O device, and ending when all related activity is completed. 
Although the I/O supervisor plays a major role in an I/O operation, it is not the only 
control program element involved. This section establishes the scope and objectives of 
the I/O supervisor. 


The User and the I/O Supervisor 


Three methods a programmer can use to request an I/O operation are shown in Figure 1. 
The actions taken by the I/O supervisor in satisfying the request are shown below the 
horizontal line that divides the figure. Specific input data must always be provided to the 
I/O supervisor, but the extent to which the programmer must define that input data 
depends upon how he requests the I/O operation. 


The user of a higher-level language (PL/I, for example) describes files and writes OPEN 
and GET statements. When his program is executed, one PL/I subroutine uses a DCB 
macro instruction to build a data control block (DCB), and an OPEN macro instruction 
to cause data management routines to build a channel program, and input/output block 
(IOB), a data extent block (DEB), and an event control block (ECB). Another PL/I 
subroutine uses a GET macro instruction, and a data management routine executes an 
EXCP macro instruction that causes entry to the I/O supervisor. 


Adjacent to the steps taken by a programmer who uses a higher-level language are shown 
the steps a programmer must take when he is using an assembler language and chooses to 
use an access method. With an access method, a programmer must essentially do what 
the PL/I compiler did; that is, he must himself write all needed DCB, OPEN, and GET 
macro instructions. 


The user of an EXCP macro instruction must provide directly all of the input that is 
required by the I/O supervisor. He may use the DCB and OPEN macro instructions, and 
he may use the I/O appendages—user-written routines that receive control at 
appropriate exits in the I/O supervisor code—but he must write his own channel 
program, and he must build his own IOB and ECB. To request any kind of I/O activity, 
he must use the EXCP macro instruction. 


The EXCP user has the option, at OPEN time, to specify the use of I/O appendages 
during the progress of I/O operations associated with his data set. These appendages 
gain control at specific points in the I/O supervisor. They gain control: 


e During page fixing 

e During extent checking, if an out-of-extent condition is detected 
e Prior to issuing the SIO instruction 

e If a PCI interruption is received 

e If anormal channel end interruption is detected 

e If any abnormal condition is detected with a primary interruption 


I/O appendages give the EXCP user a means of extending and altering I/O operations. 
For further information about I/O appendages, see OS/VS Data Management for 
System Programmers. 
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Note from Figure 1 how a higher-level language compiler uses access method routines, 
and note also the similarity between what access method routines do and what a 
programmer must do when he uses the EXCP macro instruction. 


The Page Supervisor and VS Subsystems 


The page supervisor and VS subsystems uses the EXCPVR macro instruction to request 
I/O services from the I/O supervisor. (The EXCPVR macro instruction is not available 
to other users of the I/O supervisor.) The EXCPVR macro instruction generates a calling 
sequence to the I/O supervisor that creates linkages and issues an SVC 114. The basic 
difference between an SVC 114 request and SVC 0 request is that an SVC 114 request 
needs little or no translation service and thus can be processed faster than an SVC 0 
request. 


VS subsystems prepare channel programs (CCW chains) in fixed virtual address space 
using real data addresses. Subsystems also fix pages for their own control blocks, I/O 
appendages, and data areas. 


Consequently, the I/O supervisor does not fix pages for subsystems’control blocks, I/O 
appendages, channel programs, or data areas, and does not translate the CCW data 
addresses to real addresses. However, the I/O supervisor does translate the CCW start 
address to real at EXCPVR time, and also translates the address of the last CCW+8 in 
the CSW to virtual when an I/O interruption occurs. 


The page supervisor prepares CCWs and control blocks in nonpageable storage, so page 
fixing or address translation operations are not performed by the I/O supervisor. 


The I/O Supervisor and the Control Program 


Many control program elements are involved in I/O operations besides the I/O 
supervisor. Their functions are supporting functions needed to coordinate the actions of 
the I/O supervisor with other system actions. The general system environment of the 
I/O supervisor is shown in Figure 1. 


When an EXCP macro instruction is encountered during assembly of a processing 
program, the assembler obtains the corresponding macro expansion from the 
SYS1.MACLIB data set and inserts it into the object program. The last instruction in the 
EXCP macro expansion is an SVC 0 instruction. 


During execution of the processing program, the SVC 0 instruction causes an SVC 
interruption and immediate entry to the supervisor’s SVC first level interruption handler 
(SVC FLIH). The SVC FLIH is always given control after SVC interruptions. It refers 
to a list of SVC numbers (called an SVC table) to determine 1) what SVC routine is to 
service the request and 2) whether or not the needed SVC routine is of the type that is 
contained in real storage. In the case of SVC 0, the routine to be given control is always 
the first of the two major I/O supervisor routines; the EXCP supervisor and the I/O 
interruption supervisor. 


In giving control to the EXCP supervisor, the SVC FLIH passes the address of the 
input/output block (IOB), the key item of input data, to the I/O supervisor, and 
identifies the requester type. See Figure 2 for the characteristics of I/O requesters. 


Because channels cannot translate virtual storage addresses, IOS tranlates any virtual 
addresses used in the channel program. Figure 3 shows the interface between the I/O 
supervisor and control program. 


IOS also ensures that the pages pertaining to the requested I/O operation are fixed in 
real storage. For virtual requesters, IOS passes control to the page supervisor to fix pages 
for: 
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Type of CCW Chain CCW Translation Page Fixing 
Requester Location Requirements Requirements SVC Generated 
Virtual Pageable IOS must Control blocks EXCP macro 
storage translate and appendages generates an 
CCW chains. must be fixed. SVC 0. 
Fixed (VS Pageable CCW chains have Control blocks EXCPVR macro 
subsystems storage been translated and appendages generates an 
only) by the requester. have been SVC 114. 
fixed by the 
requester. 
Nonpageable Nonpageable None None EXCP macro 
Storage generates an 
SVC 0. 
Page Nonpageable None None EXCPVR macro 
Supervisor Storage generates an 
SVC 114. 


Figure 2. Characteristics of I/O Requesters 


e I/O areas specified in the channel program 
e Control blocks (IOB, DCB, DEB, ECB/DECB and AVT) 
e I/O appendages 


Using input data it obtains from addresses in the IOB, the EXCP supervisor either starts 
the I/O device or, if the needed device is unavailable, schedules the I/O request by 
placing an element representing the request into a queue. 


For virtual requesters, starting the I/O device involves building a real channel program 
equivalent to the requester’s virtual channel program and then having the channel begin 
executing the real channel program. The real channel program is built in the system 
queue area (SQA) of real storage. 


The EXCP supervisor then gives control to the supervisor’s type 1 Exit routine. All type 
1 SVC routines (except those abnormally terminated) pass control to the type 1 Exit 
routine. 


If the routine in which the request for the I/O operation was made is still the 
highest-priority task in the system, the type 1 Exit routine restores the environment that 
existed at the time of the interruption and returns control to the dispatcher routine. The 
dispatcher routine either returns control to the requesting routine or to a routine of a new 
task with a higher priority. 


The next event occurs asynchronously. When the device has completed its part of the 
I/O operation, it causes an I/O interruption. Following I/O interruptions, control is 
given to the supervisor’s I/O first-level interruption handler (I/O FLIH). The I/O FLIH 
saves a record of the interrupted environment and gives control to the second of the two 
major I/O supervisor routines, the I/O interruption supervisor. 


For virtual and fixed requesters, the I/O interruption supervisor must retranslate the 
address of the “last CCW+8” in the CSW to the corresponding virtual address; it must 
also interface with the page supervisor to unfix any pages that were fixed specifically for 
the I/O operation just completed. In addition, it now frees the real storage area used for 
translating the CCWs of virtual requesters. 


The I/O interruption supervisor signals the requester that the I/O operation is completed 
(the task supervisor’s post routine posts the requester’s event control block), and starts 
other devices on the channel in response to any requests that were queued while the 
device, data set, or channel was busy with the request just completed. 


While the I/O interruption handler processes on interruption, one or more other 
interruptions may occur. Because I/O interruptions are disabled, they are stacked (saved 
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by the hardware), thus creating a pending interruption. After an interruption is processed 

and the user is posted, the I/O supervisor enables the system for the I/O interruptions. 

At this time, one of the stacked interruptions is fielded and processed. This process J 
continues until all pending interruptions have been fielded and all queued I/O requests 

that can be started have been started. The I/O supervisor enables the system for I/O 

interruptions one last time to check whether there are any more interruptions to be 

processed. If there are none, the I/O supervisor exits to the I/O FLIH. 


When the I/O interruption supervisor returns control to the I/O FLIH, control via the 
dispatcher, is routed either to the requesting routine or to a routine of a higher-priority 
task. 


The I/O Supervisor 


The overall objective of the I/O supervisor is to make sure that a requested I/O 
operation is performed. To achieve its objective, the I/O supervisor performs three 
major functions: starting I/O operations, terminating I/O operations, and restarting I/O 
operations (for error-correction purposes). These functions, the two major I/O 
supervisor routines, and the general control flow to and from the routines, are shown in 
Figure 4. 


Note: The EXCP supervisor and error EXCP supervisor share most of the same routines. 
However, since their functions are separate and distinct, they are treated separately 
throughout this manual. 
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Figure 4. I/O Supervision 


The basic control flow to and from the EXCP supervisor and the I/O interruption 

supervisor has already been shown in Figure 1. However, for restarting I/O operations, an SVC 
15 instruction (rather than an SVC 0 instruction) causes entry to the EXCP supervisor 

for retry of an error condition. 


In Figure 5 the major functions are expressed in more detail. The three coordinative 
functions have been added: scheduling I/O operations, starting scheduled I/O 
operations, and scheduling restarts of I/O operations. 


The first flow diagram in Figure 5 shows the flow for a straightforward I/O operation 

where the Start I/O instruction is accepted and there is no need to schedule I/O device 

activity. This flow is shown separately to illustrate how the request queue is checked J 
following completion of every I/O operation. The queue is checked repeatedly until no 

pending requests remain. If after terminating an I/O operation, the status indicators 
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I/O Supervisor Functions 


show an error condition to exist, the I/O interruption supervisor invokes a user-written 
or IBM-supplied error correction routine. Error routines can request a retry by issuing an 


SVC 15 instruction, which will result in entry to the error EXCP supervisor for the retry. 





The second flow diagram in Figure 5 shows the flow for an I/O operation that could not 
be started immediately. Note that the request queue is examined after a restart of the 
I/O operation is scheduled, just as it is when an I/O operation is terminated. 


Concept of Logical Channels 


The queues into which request elements are placed when I/O activity cannot be started 

immediately do not always correspond one-for-one with the physical channels attached is 
to a system. Rather, they correspond to logical channels. A logical channel is the set of 

all physical channels by which a device can be reached. 


Queuing in logical queues makes possible path-device groups in which a common set of 
paths can be tried for each device of a group. The result is simplified alternate-path logic. 


Unless a switching device or a two-channel switch is installed, providing multiple-path 
capability, every physical channel is also a logical channel and there is a one-for-one 
correspondence. With switching devices, however, the relationship between physical and 
logical channels varies, depending upon both the number of switches and their 
placement. 


A system without two-channel switches is shown symbolically at the top of Figure 6. 
Because each device can only be reached via one path, each physical channel is also a 
logical channel. 










Central Processing Unit Central | Central Processing Unt | tng Unit 
: Chaane . Channel n Channel wi 
3 


Control Baal Control 
Unit Baal it Unit 


| Switching Device | Device 





1/0 
Devices 


Tie) 
Devices 


Two Logical Channels 





Three Logical Channels 


Figure 6. Logical Channel—Physical Channel Relationships 


Also shown in Figure 6 is a system in which a switching device connects two control 
units. Devices B and C can then be reached via channel 1 or channel 2. Devices B and C 
are both in the logical channel comprising physical channels 1 and 2. 


Another configuration with a switching device is shown at the right in Figure 6. This 
time, devices B, C, and D may be reached via channels 1, 2, and 3; devices B, C, and D 
are all in the same logical channel. 
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Except for the 2870 Multiplexor Channel, all devices attached via the same multiplexor 
channel will always be in the same logical channel. The devices attached via a 2870 
Multiplexor Channel may be contained in more than one logical channel, however, 
because each of the four optional selector subchannels is considered separately. 
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METHOD OF OPERATION 


This section contains diagrams that are designed to give you a general knowledge of the 
I/O supervisor’s operation and to guide you through the program listing. To do this 
effectively, the diagrams must be kept at a high level. Therefore, there are some 
functions of the I/O supervisor that are not shown. Use the I/O supervisor routine 
directory (Figure 27) to find entry points into the listing for routines that are not 
included in this section. 


Each diagram consists of two pages. The (upper) first is the actual diagram. The second 
(lower) page consists of expanded text, references to other diagrams, and flowcharts, and 
a program organization chart that highlights a particular function of the I/O supervisor. 
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Figure 7. (Part 1 of 2) I/O Supervisor 
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Figure 7. (Part 2 of 2) I/O Supervisor 
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Extended Description Figure 


An SVC 0 or SVC 114 initiates an I/O operation. This causes entry into the 
EXCP supervisor where: 


@ Input data is validated. 
An RQE is initialized for the request. 
Associated pages are fixed in real storage. 
The channel program is translated (SVC 0). 
The Start I/O instruction is issued. 
The resulting condition codes are checked. 


When an J/O interruption occurs, the I/O Interruption Supervisor is entered. 
If the 1/O operation terminated successfully, its RQE is returned to the freelist 
and another interruption is processed. If there are no other interruptions 
pending, another device can be started on the channel. 


If the I/O operation results in an error condition, the error recovery routine 
is executed. 


The Error EXCP Supervisor is entered from the error recovery routine. The 
requestor’s control blocks are validated, and the I/O operation is either 
retried or terminated. 
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Extended Description Figure 


Various fields within the control blocks are checked to prevent vital system data 
from being destroyed. 


An RQE is built for each I/O request. If the request cannot be immediately 
satisfied, the RQE is placed in the logical channel request queue for that device. 


For virtual and fixed requestors, the pages involved in the requested I/O 
operation are fixed in real storage. This prevents the pages from being moved 


into auxiliary storage through normal paging operations. 


The Start I/O module builds any device-dependent prefix CCW chains needed. 
The SIO subroutine is entered to translate the virtual channel program and 
execute the SIO instruction. 


The Post Start I/O routine processes the condition codes that resulted from the 
Start I/O and translates the CCW address in the CSW back to virtual. The IOB and 
UCB are updated and the RQE is dequeued before exiting to the supervisor’s 
Type 1 exit routine. 
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Extended Description Figure 


The DEB Validity Check module, IFGDEBVR, for pageable request is entered to ensure 
that the DEB passed to IOS is on the DEB chain. If not, the ABEND routine is entered; 
EXCP SUPERVISOR otherwise, the routine goes to step 4. 


The IOB’s pointer to the DCB must be the same as the DEB’s pointer to the DCB. 
If not, the ABEND routine is entered. 
XVCKO1 9 
If the system has the protection feature, a non-supervisor requester’s key must 
equal the storage key in the DEB. The ABEND routine is entered if the keys do 
not match. 
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Figure 10. (Part 2 of 2) Get Request Element Routine 





The NEXAVL pointer points to the next available RQE in the freelist. The 
TSTLNK field of the removed RQE becomes the new pointer. 


The RQE for a particular request is initialized with pointers obtained from various 
control blocks and registers. Until this time, the only valid RQE field was the 
TSTLNK field. 


The type of request is indicated in the high-order byte of the TSTHDR field. 


For subsystem (SVC 114) requests, the pages to be fixed are specified in the re- 
quester's page fix appendage. The Page Supervisor is then entered to fix the pages. 


For virtual requests, the Page Fix Routine is executed to fix control blocks 
and appendages. 


If a previous related request has not yet completed, the RQE is placed into the 
logical channel queue. If a previous related request resulted in a permanent error 
or intercept condition, its RQE is removed from the logical channel queue and 
the Abnormal End appendage is entered. 

The RQE is queued by one of three methods: 

e@ FIFO - First In/First Out. 

e@ Priority - In order of the requesting task’s priority. 


@ Ordered Seek - In order of the cylinder address of the requested DASD. 
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fa The IOB is checked to determine if positioning is needed. If it is, the SIO sub- 
routine is entered to execute a stand-alone CCW. 






The TIC address is determined by the type of request. 







Non-subsystem ‘start’: Virtual address of the requester’s ‘start’ CCW. 


Non-subsystem ‘restart’: Virtual address of the requester’s ‘restart? CCW. 







Subsystem ‘start’: Real address of the requester’s ‘start’ CCW. 


Subsystem ‘restart’: Real address of the requester’s ‘restart’ CCW. 






Read Opposite Recovery: The address of the ROR CCW which is obtained 
from the UCB. 


EI SAVECCW is loaded with the virtual address of the requester’s first CCW. 


This CCW is used only for CRC correction. All other tape operations require 
only two CCWs. 


The ‘set mode’ command is obtained from the DEBMDM field of the DEB. 
This CCW sets parity and density. 






Figure 11. (Part 2 of 2) Start I/O Routine for Tape. 
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Extended Description Figure 


The requester is given the opportunity to modify or extend the channel program 
prior to CCW translation, or to skip the SIO operation via the requester's SIO 
appendage. 


The TSTHDR field of the RQE is checked to determine if this is a virtual request. 
If it is, a pointer to the address of the requester’s first CCW is placed in a one-word 
field (SAVECCW). The CCW translate routine is then entered to translate the 
virtual channel program to a real-channel program. 


The condition code, instruction length code, and program mask are stored in 
the IOB. 


The condition codes are: 


0 - The I/O operation was initiated and the channel is proceeding with 
its execution. 


] - The CSW was stored. 
2 - The channel or subchannel is busy. 
3 - The channel or control unit is not operational. 


The address of the RQE and the address of the physical channel used for this 
I/O operation are stored in the UCB for later use by the Sense routine. 
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Extended Description Figure 


The dequeue routine is entered at XCPPDQ to remove the RQE from the logical 
channel queue. 


If it was a virtual or fixed request, the real CCW address in the CSW is translated to 
virtual and put in the IOB along with the 7 low-order bytes of the CSW. The CSW 
status is then examined and the following actions taken: 


Catastrophic Error: The unit address is put into I/O old CSW and the Channel 
Check Handler is entered. XCPP103 


Control Unit End: The get Request Element routine is reentered at XCPO11 to 
try the I/O operation again. XCPOS6EA 


Attention Status or Device End: The I/O Interruption Supervisor is entered at 
INTATT2 to execute the attention routine, if provided, and to restart the 
channel. XCPPIO4 


For all other conditions, the Test Channel routine is entered to retry the I/O 
operation 


If it was a virtual or fixed request, the real CCW address in the CSW is translated to 
virtual and put in the IOB along with the 7 low order bytes of the CSW. The unit 


check and intervention required indicators are set in the IOB, and the RQE is de- 
queued before exiting to the Abnormal End appendage. 
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Extended Description 


A block to be used as a page-fix list is acquired from the SQA space owned by 
IOS. The TSTHDR field of the RQE points to the page-fix list until translation 
time. 


The user can make entries in the page-fix list for 1/O appendages and other data. A 
maximum of seven entries are permitted. Ten entries may be specified with a special 
return vector (+4). The user must also include entries for his DCB, DECB, and IOB. 


Pages for the IOB, ECB, DCB, AVT, and IOS appendages must all be fixed in real 
storage. Those that are not already fixed are added to the page-fix list. 


The Page Supervisor fixes all of the pages that are specified by the page-fix list. 
If the page is not already in real storage, an I/O operation (page-in) is requested. 


Figure 
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Figure 16. (Part 1 of 2) CCW Translator 
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Extended Description Figure 
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Space is obtained from the IOS owned SQA for a CCW translation header BEBLK. 
The TSTHDR field of the RQE is updated to point to the header BEBLK. The page- 
fix list obtained earlier is now pointed to by the HDRPGLK field of the header 
BEBLK. 


If the channel program exceeds the capacity of the header BEBLK, additional space 
is required to complete the translation and subroutine TCCWM300 is entered. This 
routine acquires SQA space for anew BEBLK. The new BEBLK is initialized and a 
TIC CCW is placed in the previous channel program segment. This TIC CCW contains 
a pointer to the first CCW slot in the new BEBLK. CCW translation continues. 


If the data area specified by the CCW crosses a page boundary, the page fix list 

is checked to ensure the page is fixed, and an IAL is generated. The IAL address 

is placed into the CCW’s data address field. When the channel program is executed, 
data transfer begins with the first address of the IAL and continues until a 2K 
boundary is reached. It then continues data transfer from the next address in the IAL. 
This is repeated until the count in the CCW expires. 


Translation of the unresolved TICs can be completed by referencing the BEBLKs. 
The virtual addresses in the BEBLKs are scanned until a match is made with the TIC’s 
virtual data address. The corresponding real address is then stored in the 

TIC command. 


The starting address of the real channel program is put into the HDRTICL field of 
the header BEBLK for use by the SIO routine. 
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Figure 17. (Part 1 of 2) I/O Interruption Supervisor (Part 1) 
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Extended Description 


The CSW Translator is entered at TRATCSW. [If it was a virtual or fixed 
request, the real CCW address in the CSW is replaced by the corresponding 
virtual CCW address found in the BEBLK. 


Catastrophic errors are: 


@ Channel Control Check 
@ Interface Control Check 


@ Channel Data Check 


Figure 17. (Part 2 of 2) I/O Interruption Supervisor (Part 1) 
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Extended Description 


The seven low-order bytes of the CSW are placed into the 1OB. 


The Unfix/Free routine of the CCW Translator is entered at TRAUFRE. Pages 
used for control blocks and appendages are unfixed, and space in the SQA that 
was used for the page-fix list and translation header record is freed. 


Figure 18. (Part 2 of 2) I/O Interruption Supervisor (Part 2) 
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Figure 19. (Part 2 of 2) Channel Restart Routine 


If there is an interruption pending, the I/O Interruption Supervisor is reentered 
at IECINT. 


The Channel Search routine is entered at INTCSn to determine if another I/O 


operation can be started on this logical channel. The channel table contains the 
Channel Search routine entry point for each logical channel. 


Figure 
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Figure 20. (Part 2 of 2) Channel Search Routine 


If there is no stand-alone seek found that can be started, and there are alternate 
paths available, the next associated logical channel queue is searched. This is 
repeated until all the paths are checked or a stand-alone seek is found. 


If this is a virtual request and the CCW translation was not done, this RQE is 
bypassed. This routine is reentered at INTCIC to continue the search where it 
left off. 


If this request is related to another request that resulted in an error, exit is taken 
to the Abnormal End appendage. 


If there are no I/O operations that can be started on this channel, and there are 
alternate paths available, the next associated logical channel queue is searched. 
This is repeated until all paths are checked or until a startable I/O operation 

is found. 





a0] Jostaradng Q/I ZSA/SO Or 


From 1/O 
Interruption 
Supervisor 


INPUT 





oat Oo & 


Figure 21. (Part 1 of 2) Sense Subroutine 
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Figure 21. (Part 2 of 2) Sense Subroutine 
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Extended Description Figure 


cr A flag is set in the IOB to cause this routine to be reentered after Device End occurs. 


1403 with UCS, 321 1.--Initialize the CCW chain to read the sense data into the 
2305, 3330, and 3333 extended UCB sense area. 


All other devices--Initialize the CCW chain to read up to 6 sense bytes into the UCB. 
Catastrophic errors are: 
e Channel Control Check 


e Interface Control Check 
e Channel Data Check 


The UCBPST flag in the UCB is checked to determine if the RQE is active. This flag 
is set when the I/O operation is started, and is reset when Channel End is encountered. 
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Figure 22. (Part 2 of 2) Error Routine Interface 
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Extended Description Figure 


An X’41’ in the completion code byte of the IOB, IOBCD, indicates a permanent 
error. 


An X’0C’ in the DCBFL byte of the DCB indicates IOS ERPs are to be used. 


The completion code, IOBCOD, is set to: 


X’44’ (Intercepted Request) if this request is an intercepted I/O request. 


X41’ (Permanent Error) if this request is not related to a previous request that 
resulted in a permanent error. 


Unchanged if this request is related to a previous request that resulted in a permanent 
error, 


An X’40’ is placed into the DCBFL byte to indicate error correction is in progress. 
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Extended Description 


The Validity Check routine is executed to ensure various fields within the control 
blocks are valid. If any of the tests are not satisfied, the ABEND routine, IEAQABOQO, 
is entered. 


If this is not a permanent error, the ‘I/O Error Routine in Control’ flag in the DCB is 
turned off before exiting to the Channel End Appendage. 


Figure 








PROGRAM ORGANIZATION 


CC This section contains functional organization charts and a description of the individual 
routines. There is a functional organization chart for each of the three functions of the 
I/O supervisor. 


Description of Routines 


In Figure 24, 25, and 26 the major I/O supervisor routines are grouped according to the 
functions that they perform. Brief descriptions of the routines and optional user-written 
appendage routines follow. 


Abnormal end appendage: Optional user-written appendage to which the I/O interruption 
“ supervisor exits when there is an error associated with the processing of I/O. 


Attention Routine Interface: Determines the address of the appropriate Attention routine; 
invokes the Attention routine. 


Channel Command Word Translator routine: Converts the virtual channel program to a 
real channel program. 


Channel Check Handler routine: Builds error recovery procedure interface block to 
indicate cause of channel failure; builds inboard record to describe environment at time 
of failure. 


Channel Check Handler Routine Interface: Places a code into register 15 that indicates 
which IOS routine intercepted the channel failure and branches to the Channel Check 
Handler routine. 


: Channel end appendage: Optional user-written appendage to which the I/O interruption 
C supervisor exits after a channel end interruption before indicating to the user how his 
I/O request ended. Also entered when channel end interruption is accompanied by either 
a wrong length indicator or a unit exception, or by both conditions. 


Channel Restart routine: Scans logical channel queues. Selects RQEs representing 
requests for I/O activity that can be started. Starts the I/O activity. For direct-access 
devices, first starts all seeks, then starts the data transfer. 


Channel Search routines: One for every physical channel. “‘Driver”’ type routines 
consisting mostly of branch instructions. Direct the search of logical channel queues and 
the starting of I/O activity. 


Channel Status Word Translator routine: Converts the real CSW address to a virtual 
address for virtual requesters. 


Dequeue subroutine: Locates an RQE in a logical channel queue, removes it from the 
° queue, and returns it to the freelist. 


End-of-extent appendage: Optional user-written appendage to which the EXCP 
s supervisor exits when the execution of I/O request will violate the extent limits of a 
direct-access device. 


Enqueue subroutine: Places an RQE into a logical channel queue. Normally queues by 
order of arrival. Optionally queues by requestor’s priority or by seek address. 


Error Recovery routine: Determines if I/O activity can be retried. Supervises retry 
attempts. 


Error Routine Interface: Prepares for and invokes, or schedules the execution of, an error 


( recovery routine. 
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EXCP Validity Check routine: Does most of the housekeeping for the EXCP supervisor. 
Checks for a valid DCB, DEB, IOB, and UCB. With Protection feature uses Validity 
Check subroutine to check storage keys of input data areas. 


Get Request Element routine: Obtains an ROE from the freelist and initializes it. If 
device is unavailable, causes the RQE to be queued in logical channel request queue. 


Page Fix Routine: Fixes pages in real storage for control blocks and appendages. 


Program-controlled interrupt appendage: Optional user-written appendage to which I/O 
interruption supervisor exits when program-controlled interruption (PCI) is indicated. 
Returns control to I/O interruption supervisor where the modified CCW is translated, if 
a virtual request and normal processing continues. 


Post Routine Interface: Invokes the supervisor’s Post routine, passing to it an event 
completion code and the address of the requester’s ECB. The Post routine posts the 
requester’s ECB. 


Post Start I/O routine: Routes control, depending upon resulting condition codes of the 
Start I/O instruction and status bits in the CSW (if the CSW was stored). 


Quiesce Complete subroutine: Invokes the supervisor’s Post routine, passing to it an event 
completion code and the address of the purge parameter list. The Post routine posts the 
Purge routine ECB. 


Sense subroutine: Issues a Start I/O instruction to cause a Sense command to be 
executed. Places the first two bytes of sense data in the requester’s IOB. 


System Environment Recording Routine Interface: Places an error code into the machine 
check new PSW. Uses a Load PSW instruction to invoke the SERO or SER1 routine. 


Start I/O appendage: Optional user-written routine to which the EXCP supervisor exits 
before the execution of the Start I/O (SIO) instruction for a requested I/O operation. 


Start I/O routine for direct-access devices: Prepares an I/O supervisor channel program 
consisting of three CC Ws: a Seek command, a Set File Mask command, and a 
Transfer-in-Channel command. The 2314 direct-access device uses the Start I/O 
subroutine twice, once to perform a stand-alone seek and once to perform the data 
transfer. 


Start I/O routine for magnetic-tape devices: Prepares an I/O supervisor channel program 
that may consist of two CCWs (normal start, restart, or opposite direction recovery), or 
three CCWs (operations following a cyclic redundancy check condition). The last CCW 
contains a Transfer-in-Channel command containing the address of the requester’s first 
CCW. Uses the Start I/O subroutine. 


Start 1/O routine for unit record and communications devices: Initializes a register with the 
address of the requester’s first CCW. Uses the Start I/O subroutine. 


Start I/O subroutine: Prepares the CAW and issues a Start I/O instruction. Does some 
checking of resulting condition codes. 


Test Channel routine: For selector channels, issues a Test Channel instruction. Causes the 
RQE to be queued if the channel is unavailable. Tries all channels of multiple-path 
arrangements. Does not issue a Test Channel instruction for byte-multiplexor channels. 


Trap routines: One for each device class. Perform device-dependent functions following 
channel-end and device-end interruptions. 


Validity Check subroutine: Checks storage keys of areas containing IOB, DCB, and ECB 
against the requester’s protection key; checks that DEB storage key is 0. 
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DIRECTORIES 


C 


This section contains cross-reference lists that include a data area directory, module 
directory and a routine directory. 


Data Area Directory 


Figure 27 contains a summary of information about the major data areas used by the I/O 
supervisor. The column headings and their meanings are: 


* Data Area Name: The name of the data area and its abbreviation, if there is one. 
Beginning Symbol: Meaningful only for data areas contained in the nucleus. This symbol 
“ 


identifies the beginning of the data area, and can be used to locate the data area in the 
program listings. 


Creation: Contains some indication as to the origin of the data area. 


Permanent Storage Assignment means that the area is part of the hardware and 
always occupies the real-storage location shown in the “Storage Area’’ column. 


Requester means that creation and maintenance of the data area is the responsibility 
of the requester of the I/O activity. All requesters do not have to explicitly create the 
needed data areas. (See Figure 1 and its accompanying text.) 


System Generation means that the data area is created during system generation. 
(This means that space is set aside for the area during system generation.) 


Supervisor means that the area is created and maintained by the supervisor portion of 
( the control program. 


Storage Area: Indicates where the data area can be found in real storage. Where 
‘“‘Requester’s’”’ appears in this column, the data area is obtained by the requester when it 
is needed; consequently, its location is not fixed. 


Size: The size of the data area. 


Means of Access: The most commonly used way of referring to the data area or one of its 
entries. 
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Beginning 


Data Area Name Symbol Creation Storage Area Size Means of Access 
Alternate Path SCPCHnB System Nucleus Three to Five Beginning symbol. 
Table Generation Fullwords, 
Depending Upon 
No. of Paths to 
a Device 
Beginning-End BEBNXTB I/O Supervisor SQA 136 Bytes TSTHDR field of the ROE. 
Block (BEBLK) 
Channel Address CAWLOC Permanent 72(48) Word Beginning symbol. 
Word (CAW) Storage 
Assignment 
Channel Command By Requester Requester’s Doubleword Address at requester’s first CCW 
Word (CCW) when Needed. Nucleus is contained at off-sets IOBST 
IOS CCWs are (start) or IOBSRS (restart) fields 
Created of IOB. 
during System 
Generation Access to IOS CCWs varies 
with device type and 
circumstances. 
Channel Error CEBTAB ~ System Nucleus 24 Bytes Beginning Symbol. 
Block Table Generation 
Channel Status CSWLOC Permanent 64(40) Doubleword Beginning symbol. 
Word (CSW) Storage 
Assignment 
Channel Table IECCST System Nucleus One-Word To locate entry for specific 
Generation Entry for channel, channel number is 
Each Physical multiplied by four and added to 
Channel beginning address of table. 
Data Control By Requester Requester’s Varies with Symbolic names equated to offsets 
Block (DCB) Access Method of files. 
Data Extent By Requester Requester’s Varies with Symbolic names equated to offsets 
Block (DEB) Devices and of fields. 
Access method 
Device Statistics IECSTB System Nucleus One 10-Byte Normally, the address of an entry 
Table Generation Entry for Each for a device is obtained by 
Device, plus multiplying the statistics table 
One 10 Byte index in the device’s UCB by 10 
Control Field and adding the result to the 


beginning address of the device 
Statistics table: 


STATAB x 10 + Beginning Address 


When there are more than 256 
devices, however, the following 
method is used: 


(STATAB) + 256) x 10 + Beginning 
Address 


Figure 27. (Part 1 of 3) Data Area Directory 
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Data Area Name 


Device Table 


Event Control 
Block (ECB) 


Indirect Address 
List (LAL) 


Input/Output 
Block (IOB) 


Logical Channel 
Table (LCH) 


Page Fix List 
(PGFX) 


Program Status 
Word (PSW) 


SVC Old PSW 
I/O Old PSW 
1/O New PSW 


Figure 27. (Part 2 of 3) Data Area Directory 


Beginning 


Symbol Creation 


DEVTAB System 
Generation 


By Requester 


IALCHAIN I/O Supervisor 


By Requester 


LCHTAB 
IECILCH 


System 
Generation 


FXLSTCHNI/O Supervisor 


Permanent 
Storage 
Assignment 

SVCOPSW 

IOPSWO 

IONPSW 


Storage Area 


Nucleus 


Requester’s 


SQA 


Requester’s 


Nucleus 


SQA 


Size 


One 6-Byte 
Entry for Each 
Queuing Option 
Selected for Each 
Device Type 


Word 


136 Bytes 


32 Bytes, plusa 
Variable Amount 
that Depends Upon 
the Access Method 


One Doubleword 
Logical Channel 
Word for Each 
Logical 


136 Bytes 


32(20) 
56(38) 
120(78) 


Means of Access 


In the above, n is the number one 
or two to indicate the second and 
third 256-entry group in the device 
statistics table. The UCB addresses 
in the control field of the table are 
used to determine the number n. 


For the 2314 Direct-Access Storage 
Facility, the low-order four bits of 
the fifth sense byte are added to the 
Statistics table index before the 
index is used. 


Desired entry located by adding device 
table index from UCB to beginning 
address of table. A specific field 
within the entry is then located by 
adding the field’s offset to the 

above sum. 


Via address contained at offset 5 of 
the IOB. 


HDRINDL field of the CCW 
translation header BEBLK. 


Initially, address is provided 
in register 1 by requester. It 

is moved to and maintained in 
register 2 (IOBREG). 


To locate a needed logical 
channel word, the logical 
channel index in the UCB is 
multiplied by 8 and added to the 
beginning address of the 

logical channel table. 


Before CCW translation, the 
TSTHDR field of RQE. 
HDRPGLK field of the translation 
header BEBLK. 


Beginning symbol. 
Beginning symbol. 
Beginning symbol. 
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Beginning 
Data Area Name Symbol Creation 
Request Queue TSTAR System 
Element (RQE) TECIOQET Generation 


Task Control By Supervisor 
Block (TCB) 

Translation BEBNXTB I/O Supervisor 
Header BEBLK 

Unit Control System 

Block (UCB) Generation 


UCB Lookup Table UCGTAB System 
IECILKI Generation 
Volume Statistics System 


Table 


Figure 27. (Part 3 of 3) Data Area Directory 


Storage Area 


Nucleus 


Nucleus 


SQA 


Nucleus 


Nucleus 


Nucleus 


Size 


20 Bytes 
20 Bytes 


171 Bytes 


136 Bytes 


Variable from 24 
10 288 Bytes. 

one UCB for Each 
Device Address 
Defined for the 
System. 


Variable, depending 
upon Number and 
Addresses of Devices, 
Control Units, and 


Means of Access 
Varies depending upon status of J 
request: 


Address of RQE available for 
assignment is contained in location 
NEXAVL. 


Address of assigned (but not 
queued) RQE is contained in 
requester | (TSTREG). 


Address of the first RQE in a logical ~ 
channel queue is contained in the 
LCHFYTS field of the logical channel 
word for that queue. 


Symbolic names equated to offsets 
of fields. 


TSTHDR field of the RQE. 


Initially, via address 
contained in the UCB address 
field of DEB. The address is 
moved to the request queue 
element. Following 
interruptions, the address of 
the UCB for the device that 
caused the interruption is 
obtained via the UCB lookup 
table. 


Beginning symbol. 


Channels, and Number 


of Zero Entries 
Eliminated by Table- 
Building Routine. 


24 Bytes for Each 
Entry 


Via address contained in field 
at offset 49 of the UCB 
containing the volume. Each 
entry is effectively an 
extension to a UCB. 
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Module Directory 


Figure 28 contains information about the physical structure of the I/O supervisor. The 
column headings and their meanings are: 


Symbolic Name: The symbolic name of a table, routine, object module, or control section. 
Description: The type of item to which the symbolic name applies. 


Object Module Name: The name of the object module containing the item. The 
microfiche cards containing program listings are ordered by object module name. 


Control Section Name: The name of the control section containing the item. 


Publication References: Places in this publication where more information about the item 
can be found. 


Library: The data set normally containing the item. 


Code Data Set 
NUC SYSI.NUCLEUS 
SVC SYS1.LPALIB 


If SVC Routine: Information about I/O supervisor SVC routines. There are four 
types of SVC routines. 


Type 1 SVC routines are part of the nucleus and are disabled (masked) for all 
interruptions except machine check interruptions. 


Type 2 SVC routines are part of the nucleus but may be enabled (interruptable) for 
part of their operation. 


Type 3 SVC routines are nonresident and may be enabled. 
Type 4 SVC routines are nonresident and may be enabled. 
Name: The name of the item being described. 


When the control section name for an item is not the same as the object module name, 
the item will have two entries in the table—one filed by control section name and the 
other filed by object module name. Therefore, it is unnecessary to check beyond the first 
column when looking for a symbolic name. 


The three major groups of routines that make up the I/O supervisor—the EXCP 
supervisor, the I/O interruption supervisor, and the error EXCP supervisor—are 
contained in the control program nucleus. As a result, there are no CSECT names or 
load module names in these three major groups of routines. Linkage parameter lists, 
usually associated with multi-load routines, are also unnecessary. Therefore entry points 
are not of the formal one-or-two-entries-only type (due to stringent parameter list 
requirements), but rather are ordinary symbolic labels, undistinguishable from other 
symbolic labels. 
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Symbolic 
Name 
CAWLOC 
CSWLOC 
DEVTAB 
IEAQFX00 


IECCST 
IECILCH 
IECILK1 
IECINT 


IECINTRP 


IECIOQET 
IECIPRTS 


IECIPR16 


IECSTB 


IECWTORA 


IECWTORB 


IECWTORC 


IECWTORD 


IECWTORE 


IEC1052A 


IEC1402A 


IEC1402B 


TEC1403A 


IEC1442A 


IEC23XXF 


Description 


Table 
Table 
Table 


Object 
Module 


Table 
Table 
Table 


Routine 


Object 
Module 


Table 


Object 
Module 


Object 
Module 


Table 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Object 
Module 


Object 
Module 
Name 


* 
* 


* 


IEAQFX00 


IECINTRP 


* 


IECIPRTS 


IECIPR16 


* 


IGE0125C 


IGE0125C 


IGE0225C 


IGE0325C 


IEC0425C 


IGE0000D 


IGE0001C 


IGEO0101C 


IGE0000G 


IGEOQO0E 


* 


Control 
Section 
Name 


* 
* 


* 


IEAQFX00 


IECINTRP 


* 


1GC016 


IGCO016 


* 


Publication 
Reference 
Data Areas 
Data Areas 
Data Areas 


All 


Data Areas 
Data Areas 
Data Areas 


Program 


Organization 


Method of 
Operation 


Data Areas 


Appendix A 


Appendix A 


Data Areas 


IECWTORA Appendix H 


IECWTORB Appendix H 


IECWTORC Appendix H 


IECWTORD Appendix H 


IECWTORE Appendix H 


IEC1052A 


IEC1402A 


IEC1402B 


IEC1403A 


IEC1442A 


* Refer to installation system generation listing. 


1 Do not confuse with the Write-to-Operator SVC routine (SVC 35), described in other OS/VS publications. 


Figure 28. (Part 1 of 5) Module Directory 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Macro 
Instruc- 


Library Type tion 


NUC 
NUC 


NUC 
NUC 
NUC 
NUC 


NUC 


NUC 
SVC 


SVC 


NUC 
SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


NUC 


2 


2 


PURGE 


PURGE 


SVC 
No. 


16 


16 


If SVC Routine 


Name 


Channel Address Word 
Channel Status Word 
Device Table 

IOS Nucleus 


Channel Table 
Logical Channel Table 
UCB Lookup Table 


I/O Interruption Supervisor 


Error Interpreter Routine 


Request Queue Element Table 
Purge Routine (TSO) 


Purge Routine 


Statistics Table 


Write-to-Operator Routine, 
Load 1 of 5! 


Write-to-Operator Routine, 
Load 2 of 5! 


Write-to-Operator Routine, 
Load 3 of 5! 


Write-to-Operator Routine, 
Load 4 of 5! 


Write-to-Operator Routine, 
Load 5 of 5! 


1052, 3210, and 3215 Error 
Routine 


2540 Error Routine, 
Load 1 of 2 


2540 Error Routine, 
Load 2 of 2 


1403 and 1443 Error Routine 


2501, 2520, and 1442 Error 
Routine 


2305, 2314, 2319, 3330, and 
3333 Error Routine 
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Symbolic 
Name 


IEC24001 


IEC3211A 


IEC3211B 


IEC3420J 


1GC000 


1GC0001G 


1GC0003C 


1GC00033 


IGCOO09A 


IGCOO1OA 


IGC0024 


IGCO015 


IECO16 


IGCOI6 


1GC092 
IGEO000D 


IGEOQOOOE 


IGEOOOOF 


IGE0000G 


Description 
Control 
Section 


Control 
Section 


Control 
Section 


Control 
Section 


Routine 


Object 
Module 


Object 
Module 


Control 
Section 


Object 
Module 


Object 
Module 


Control 
Section 


Routine 


Control 
Section 


Control 
Section 


Routine 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 
Name 


IGE09001 


IGEOOOF 


IGE0100F 


IGE08001 


Control 
Section 
Name 


1EC24001 


IEC3211A 


IEC3211B 


1EC3420J 


1GC00001G SVC017 


IGC0003C 


IGC0003C 


IGCO009A 


IGCOOIOA 


1GC0002D 


IECIPRTS 


IECIPR16 


* 


IGE0000D 


IGEOOOOE 


IGEOOOOF 


IGE0000G 


1GC00033 


1IGC00033 


IGCO009A 


IGCOO10A 


1GC0024 


IGCO16 


IGCO16 


* 


IEC1052A 


IEC1442A 


IEC3211A 


IEC1403A 


* Refer to installation system generation listing. 


Figure 28. (Part 2 of 5) Module Directory 


Publication 
Reference 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Method of 
Operation, 
Program 
Organization 
Appendix A 
Appendix A 
Appendix A 
Appendix A 
Appendix H 


Appendix A 


Method of 
Operation, 
Program 
Organization 
Appendix A 
Appendix A 


Appendix A 
Appendix H 


Appendix H 


Appendix H 


Appendix H 


Macro 
Instruc- 


Library Type tion 


SVC 


SVC 


SVC 


SVC 


NUC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


NUC 


SVC 


SVC 


NUC 
SVC 


SVC 


SVC 


SVC 


EXCP 


RESTORE 


IOHALT 


IOHALT 


-none- 


DEVTYPE 


-none- 


PURGE 


PURGE 


-none- 


SVC 
No. 


0 


17 


33 


33 


91 


24 


16 


16 


92 


If SVC Routine 


Name 


2400/3400 Tape Series Error 
Routine, Load 6 of 7 

3211 Error Routine 

3211 Error Routine 
2400/3400 Tape Series 


Error Routine, Load 7 of 7 
EXCP Supervisor 


Restore Routine 


IOHALT Routine 


IOHALT Routine 


VOLSTAT Routine 


Loads 2305/3330/3333 


DEVTYPE Routine 


Error EXCP Supervisor 


Purge Routine (TSO) 
Purge Routine 

TCB EXCP Routine (TSO) 
1052, 3210, and 3215 

Error Routine 

2501 and 2520 Routine 


3211 Error Routine 


1403 and 1443 Error 
Routine 
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Symbolic 
Name 


IGE00001 

IGE0001C 
IGEOO10A 
IGE0010B 
IGEOOIIA 
IGE0011C 
IGE0011D 
IGEOOIIE 
IGE0025C 
IGE0025E 
|GEO100F 
IGE01001 

IGEO101C 
IGEO110B 
IGEO125C 
IGEOI25E 
IGE02001 

IGE0225C 
IGEO0225E 


IGE03001 


Description 
Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


* Object 


Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 


Object 
Module 
Name 


IGE00001 


IGE0001C 


IGEOOIOA 


IGE0010B 


IGEOOIITA 


IGEO011C 


IGE0011D 


IGEOOIIE 


IGE0025C 


IGEO025E 


IGE0O100F 


IGEO100I 


IGEO101C 


IGEO110B 


IGEO125C 


IGEO125E 


IGE02001 


IGE0225C 


IGE0225E 


IGE03001 


Control 
Section 
Name 


IGE00001 


IEC1402A 


IGEO010A 


IGE0010B 


IGEOO11A 


IGE0011C 


IGE0011D 


IGEOOIIE 


Publication 
Reference 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


IECWTORA Appendix H 


IGE0025E 


IEC3211B 


IGEO100I 


IEC1402B 


IGE0110B 


IECWTORB 


IGEO125E 


IGE02001 


IECWTORC 


IGE0225E 


IGE03001 


Appendix A 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix H 


Appendix C 


Appendix H 


Appendix H 


Appendix C 


Appendix H 


Macro 
Instruc- SVC 
Library Type tion No. 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


1 Do not confuse with the Write-to-Operator SVC routine (SVC 35), described in other OS/VS publications. 


Figure 28. (Part 3 of 5) Module Directory 
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If SVC Routine 


Name 
2400/3400 Tape Series 
Error Routine, Load 1 of 7 


2540 Error Routine, 
Load | of 2 


2250 Error Routine 


2260 and 1053 Error Routine, 
Load 1 of 2 


2495 Error Routine 


1287 Error Routine 


1288 Error Routine 


1419/1275 Error Routine 


Write-to-Operator Routine, 
Load 1 of 5! 


1/O Purge Routine 


3211 Error Routine, 
Load 2 of 2 


2400/3400 Tape Series 
Error Routine, Load 2 of 7 


2540 Error Routine, 
Load 2 of 2 


2260 and 1053 Error Routine, 
Load 2 of 2 


Write-to-Operator Routine, 
Load 2 of 5! 


Volume Verification Routine, 
Load 1 of 2 


2400/3400 Tape Series Error 
Routine, Load 3 of 7 


Write-to-Operator Routine, 
Load 3 of 5! 


Volume Verification Routine 
Load 2 of 2 


2400/3400 Tape Series Error 
Routine, Load 4 of 7 





Symbolic 
Name 


IGE0325C 


IGE04001 


IGE0425C 


IGE0425F 


IGEO800I 


IGE09001 


IGFCAT 


IGX00015 


INTAPROI 


INTATT 


INTCS 


INTDAT 


INTERR 


INTSEN 


INTTAT 


INTURT 


INT027 


IONPSW 
IOPSWO 


Description 


Control 
Section 


Object 
Module 


Control 
Section 


Object 
Module 


Object 
Module 


Object 

Module 
Routine 
Object 

Module 
Routine 
Routine 
Routine 
Routine 
Routine 
Routine 
Routine 
Routine 


Routine 


Table 
Table 


PRGCOMA Routine 


Object 
Module 
Name 


IGE0325C 


IGE04001 


IGE0425C 


IGE0425F 


IGEO800! 


IGE09001 


1GX00015 


Control 
Section 
Name 


Publication 
Reference 


IECWTORD Appendix H 


IGE04001 


Appendix H 


JECWTORE Appendix H 


IGE0425F 


TEC3420J 


IEC24001 


IGFCAT 


IGX00015 


* Refer to installation system generation listing. 


Program 
Organization 


Appendix H 


Appendix H 


Program 
Organization 


Appendix A 


Appendix B 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Data Areas 
Data Areas 


Program 
Organization 


Macro 
Instruc- 
Library Type tion 


SVC 


SVC 


SVC 


SVC 


SVC 


SVC 


NUC 


SVC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


SVC 
No. 


1 Do not confuse with the Write-To-Operator SVC routine (SVC35 described in the other OS/VS publications. 


Figure 28. (Part 4 of 5) Module Directory 


If SVC Routine 


Name 
Write-to-Operator Routine, 
Load 4 of 51 


2400/3400 Tape Series Error 
Routine, Load 5 of 7 


Write-to-Operator Routine, 
Load 5 of 51 


System Environment Recording 
Message Routine 


2400/3400 Tape Series Error 
Routine, Load 7 of 7 


2400/3400 Tape Series 
Error Routine, Load 6 of 7 


Channel Check Handler 
Routine 


Extended SVC Routine 


Alternate Path Retry 
Routine 


Attention Routine Interface 


Channel Search Routine 


Trap Routine for Direct-Access 
Devices 


Error Routine Interface 


Sense Subroutine 


Trap Routine for Magnetic 
Tape Devices 


Trap Routine for Unit Record 
and Communications Devices 


Channel Restart Routine 


I/O New PSW 
I/O Old PSW 


Quiesce Complete Subroutine 
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Symbolic 
Name 


SERROI 


Description 


Routine 


SVCOPSW Table 


SVCO17 


TSTAR 
VALCHK 


XCPCH 


XCPPDQ 


XCPPIO 


XCPPNQ 


XCPPST 


XCPSIO 


XCPTST 


XIODSKI 


XIOTPE 


XIOUR 


XVCKO1 


Control 
Section 


Table 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Routine 


Object 
Module 
Name 


* 


a 


1GC0001G 


Control 
Section 
Name 


* 


a 


SVCO17 


* Refer to installation system generation listing. 


Figure 28. (Part 5 of 5) Module Directory 
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Publication 
Reference 


Program 
Organization 


Data Areas 


Appendix A 


Data Areas 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 


Program 
Organization 
Method of 
Operation 
Method of 


Operation 


Method of 
Operation 


Method of 
Operation 


Method of 
Operation 


Method of 
Operation 


Library Type tion 


NUC 


SVC 3 


NUC 
NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


NUC 


Macro 

Instruc- SVC 
No. 

RESTORE 17 


If SVC Routine 


Name 

SER CCH/MCH Routine 
Interface 

SVC Old PSW 


Restore Routine 


Request Queue Element Table 
Validity Check Subroutine 


Test Channel Routine 


Dequeue Subroutine 


Post Start I/O Routine 


Enqueue Subroutine 


Post Routine Interface 


Start 1/O Subroutine 


Get Request Element 
Routine 


Start I/O Routine for 
Direct-Access Devices 


Start I/O Routine for 
Magnetic Tape Devices 


Start I/O Routine for 
Unit Record and 
Communications Devices 


EXCP Validity Check 
Routine 





C 


~weew «eo irate cao 
Wicca, 


ia ad 


Routine Directory 


Figure 29 lists the routines that make up the I/O supervisor’s nucleus. The routines are 
listed alphabetically by name with their entry point and reference. 





Routine Name 


ABTERM interface 
Alternate Path Retry 
Attention Routine Interface 


CCW Translator 

Channel Check Handler 

Channel Check Handler Interface 
Channel Restart 

Channel Search 

CSW Translate 


DAVV Attention 

DDR Appendage Support Interface 
DEB Validity Check 

Dequeue 

Direct Access Extent Test 

Direct Access Trap 


Enqueue Subroutine 
Error EXCP 

Error Recovery Routine 
Error Routine Interface 
EXCP Supervisor 


FIFO Enqueue 
Get Request Element 
HIO 


I/O Interruption Supervisor 
Inline Fix/Unfix Subroutine 


Local GETMAIN Subroutine 


Machine Check Handler 
Machine Check Handler Interface 


Ordered Seek Enqueue 


Page Exception Handler 

Page Fix 

Page-Fix Appendage Interface 
Post Routine Interface 

Post Start I/O 

Priority Enqueue 

Program Check Recovery 


Entry Point 


XERX04 
INTAPRO1 
INTATT 


TRATCCW 
IGFCAT 
SERRO1 
INT027 
INTCSn 
TRATCSW 


INTATN 


DDRAPNVT 


DEBVAL 
XCPPDQ 
EXTTST 
INTDAT 


XCPPNQ 
IECXCPER 
INTERR 
XEXCP 
XCPENQ 
XCPTST 
IECIHIO 


IECINT 
ILFXS100 


GTFRM000 


IGFNUCO0O0 
IERRO1 


XCPSEQ 


IECXPGEY 
TRAFIXA 
PGFXINT 
XCPPST 
XCPPIO 
XCPPRQ 
IECCPLOO 


Figure 29. (Part 1 of 2) Routine Directory 


Method of 
Operation 


Figure 


16 


19 


23 


10 


17 


15 


14 


Program 
Operation 
Figure 


25 
24 
25 


25 
25 


24,26 
26 
26 
25,26 


25 
25 


25 
24 
25 
24 
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Method of Program 


Operation Operation 
Routine Name Entry Point Figure Figure 
Quiesce Complete Subroutine PRGCOMA GRA 25 
RMS Channel Restart Interface INTRMS 
RMS Module Loader Interface IECRMS ee eee 
Sense Subroutine INTSEN 21 25 
Service Interface Routine IEASIRBE ” re 
SIO Subroutine XCPSIO 13 24 
Start I/O Routine for DASD XIODSK 12 24 
Start I/O Routine for Tape XIOTPE 11 24 
Start I/O Routine for UR and TP XIOUR xk 24 
Start I/O Routine for 2305 XEUSIO nee 24 
System Environment Recording IEAMCHO00 tons 25 
System Environment Recording SERRO1 ee 25 
Interface 
Test Channel XCPTCH dee 24 
TSO TCB EXCP Interface IECXPT 
Unfix/Freemain TRAUFRE 
Unit Record Trap INTURT 
Validity Check XVCKOl1 9 24 


Figure 29. (Part 2 of 2) Routine Directory 
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DATA AREAS 


The major paths by which I/O supervisor routines can reach specific data areas are 
shown in Figure 30. The longer paths are seldom used, because pointers to major data 
areas are normally maintained in registers. For example IOBREG, which is register 2, 
will normally contain the address of the IOB for a request in process. One exception is 
the Purge routine, which must use the longer paths in locating and removing elements 
from queues. 
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Channel Address 
Word 


Channel Command 
Word(s) (1OS 
Channel Program) 












Unit Control Request Queue 
Block Element 
Unit Control Logical Channel Request Queue 
Block Word Element 


Unit Control Request Queue 
Block Element 








Channel Command 
Word(s) (Request- 
er's Channel Prog. 


Input/Output Event Control 
Block Block 


Data Control 
Block 







Unit Control Request Queue 
Block Element 


Unit Control Logical Channel Request Queue 
Block Word Element 
Unit Control ) Request Queue 
Block Element 


Unit Control Request Queue 
Block Element 





Data Extent 
Block 


Unit Control Task Control 
Block Block 

Task Control 1st 1OB in Purge 
Block Chain 


There ts no significance 
to the number of data areas 
shown in this figure. 





Unit Control Logical Channel Request Queue 
Block Word Element 
Unit Control Request Queue 
Block Element 


Data Area Name Field Name Content 


Data Extent Block 1(1) DEBTCBAD Task Control Block 
17(11) DEBUSRPG First LOB in Purge Chain 
25(19) DEBDCBAD Data Control Block 
33(21) DEBUCBAD Unit Control Block 
Input/Output Block 5(5) IOBECB Event Control Block 
17(11) IOBST Requester’s Channel Program 
21(15) 1OBDCB Data Control Block 
Logical Channel Word 0(0) LCHFTS First ROQE in Logical Channel Queue 
2(2) LCHLTS Last RQE in Logical Channel Queue 


Request Queue Etement 0(0) TSTLNK Next RQE in Logical Channel Queue 
2(2) TSTUCB Unit Control Block 
5(5) TSTIOB Input/Output Block 
9(9) TSTDEB Data Extent Block 
12(0C) TSTKEY Protect Key 
13(O0D) TSTTCBAD Task Control! Block 


16(10) TSTHDR Page-fix list before translation. Translation 
Header BEBLK during and after translation. 


Unit Control Block 10(A) UCBLCI Value which, when multiplied by 8, becomes an index 
to the logical channel word for the logical channel 
containing device. 





Figure 30. Data Area Relationships 
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C 


Data Area Layouts 


This section contains descriptions of the principle data areas used by routines of the I/O 
supervisor. Refer to OS/VS2 System Data Areas for data areas that are common to 
other VS functions. 


The symbolic names shown in individual data area fields represent the offset, in bytes, 
from the beginning of a table to the field. Access is gained to a specific field by using an 
instruction in which the beginning address of the table (usually contained in a register) is 
the base address, and the symbolic field name represents the displacement. 


Usage of the data area fields can be traced in the I/O supervisor listings by first locating 
the symbolic field names in the cross-reference table at the back of the listings and then 
noting where the names are used. Where no symbolic name appears in a data area field, 

the field is not referred to by the I/O supervisor. 


Alternate Path Table 


The alternate path table (Figure 31) contains a record of the paths by which a device can 
be reached. There is one alternate path table for each logical channel that contains more 
than one channel. In the listings, an alternate path table immediately precedes the Test 
Channel routine for its associated channel. 


Channel Address Path Number 
No. of Paths Sum of Path Numbers 


Figure 31. Alternate Path Table 








Two to Four Fullword 
Entries, Depending Upon 
Number of Alternate Paths. 


} Control Entry. 
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Appendage Vector Table 


The Appendage Vector Table (AVT, Figure 32) contains the virtual address of each I/O 
appendage and the number of pages that must be fixed for each appendage. The first 
byte of each 4-byte field contains the number of pages to be fixed for the appendage 
whose virtual address is in the remaining three bytes of the field. 





APGEOE End of Extent (EOE) 

APGSIO Start 1/O (SIO) and 
Page-Fix Appendage. 
See Note. 

APGPCI Program Controlled 
Interrupt (PCI) 

APGCHE Channel End (CE) 

APGABE Abnormal End (XCE) 


Note: If bit O of byte 4 is set to 1, the 
SIO appendage contains the page fix 
(PGFX) appendage. If bit 1 of byte 4 is 
set to 1, the SIO appendage is entered 
even if ERP is active. 





















Dec = Hex 
0 0 
4 4 
8 8 
12 OC 
16 10 
Field Dec 
APGABE 0016 
APGCHE 0012 
APGEOE 0000 
APGPCI 0008 
APGSIO 0004 


Figure 32. Appendage Vector Table 


0010 CE 0013 O00D 
0O00C EOE 0001 0001 
0000 PC] 0009 0009 
0008 SIO 0005 0005 
0004 XCE 0017 0011 


BEBLK (Beginning-End Block) 


A beginning-end block (BEBLK, Figure 33) contains the real copy of the CCWs and the 
beginning and ending addresses of the user’s virtual CC Ws, of which these CCWs are 
the equivalent. A BEBLK can map up to 15 contiguous CCWs. If two CCW extents are 
mapped, then up to 14 CCWs and a second set of beginning and ending addresses of the 
user’s virtual CCWs are contained in the BEBLK. The second extent information is 
located directly after the last CCW required for the first range. 
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00 00 
BEBNXTB BEB2XTNT 
Address of second BEBVRST and 
Chain pointer to next BEBLK BEBVREN when two extents 
are mapped in a BEBLK 
08 08 
BEBVRST BEBVREN 
Address of first virtual CCW Address of last virtual CCW+8 
in first extent in first extent 
16 10 
24 18 
32 20 
Offset 
ee BEBVRST BEBVREN 
of first Address of first virtual CCW Address of last virtual CCW+8 
CCW extent in second extent in second extent 
CCWn 
Field Dec Hex Field Dec Hex 
BEBNXTB 00 00 BEBVREN 12 oc 
BEB2XTNT 04 04 CCW 16 10 
BEBVRST 08 08 CCW2 24 18 


Figure 33. Beginning-End Block 





Channel Address Word 


A channel refers to the Channel Address Word (CAW, Figure 34) during execution of a 
start I/O instruction. It provides the channel with a means of determining the real 
storage location from which it should fetch the first CCW. The CAW is permanently 
assigned to real storage location 72. 
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Dec Hex 


0 0 CAWLOC 





Protection Address of CCW 
Key 

Field Dec mes 

CAWLOC 0000 0000 


CCW Address 0001 0001 


Figure 34. Channel Address Word 





Channel Command Word 


The Channel Command Word (CCW, Figure 35) indicates to a channel what I/O 
operation should be started. For operations involving data transfer, the CCW also 
indicates the real storage location into which data is to be placed or read from, and how 
many bytes of data are to be transferred. 





a o/s 


io] 


78 


*Flags and Masks 


Flag 
Field 


Flags 


Contains 


Chain-data 
(CD) flag 


31 32 3637 3940 47 48 63 
Hex Means 
X'80' The data area designated by the next CCW to be 


used with current operation. 


Chain-command 


(CC) flag X'40' The operation specified by the command code of the 
next CCW is to be initiated on normal completion of 
the current operation. 

Suppress-incorrect- X'20' The incorrect length status bit in the channel status 

length indicator (SILI) word is not to be set by the channel if an incorrect 
length condition is detected. 

Skip flag X'10’ Data transfer to storage is suppressed. Valid only 
for read, read backward, and sense operations. 

PCI flag X'08’ The channel causes an interruption when this CCW 
is fetched. 

Indirect address 

flag *’04' The channel references the indirect address list at the 


start of the I/O operation and whenever a 2K 
boundary is reached during data transfer. 


Figure 35. Channel Command Word 
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CCW Translation Header BEBLK 


The CCW translation header BEBLK (Figure 36) contains the addresses of the first and 
last CCWs in the corresponding virtual channel program. This BEBLK can map up to 12 
contiguous CCWs. If two CCW extents are mapped, then up to 11 CCWs and a second 
set of beginning and ending addresses of the user’s virtual CCWs are contained in the 
header BEBLK. The second extent information is located directly after the last CCW of 
the first extent. This block also contains pointers required for translation of the entire 
channel program. Figure 37 shows the interrelationship of the translation control blocks. 
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nnn neler camila een ianenttelmeaiililal 


Dec 
00 


112 


128 


Hex 
00 


70 


80 





BEBNXTB BEB2XTNT BEBVRST BEBVREN 


Chain pointer to next Address of BEBVRST Address of first virtual Address of last virtual 
BEBLK and BEBVREN for CCW in first extent CCW in first extent 
second CCW extent: 
otherwise, zero 





BEBVRST BEBVREN 


Address of first virtual Address of last virtual 
CCW in second extent CCW+8 in second extent 












HDRPGLK HDRINDL HDRTICL 
Pointer to page-fix list Pointer to indirect During translation- 
address list address of first unresolved 










TIC CCW. After trans- 
lation-address of first 
real CCW. 







TCCWITCCW | TCCW|TCCW 
MODB CCWLIINDL | OPBT 
1 2 3 4 

































TCCWMFAD TCCWMFCT HDRRQE Field Dec 
Pointer to SIO extend or Number of Address of BEBNXTB 000 
PCI modify parameter entries in SIO] ROE BEB2XTNT 004 
list See BEBVRST 008 008 
parlhoorans BEBVREN 012 ooc 
ae HDRPGLK 112 070 
HDRINDL 116 074 
TCCWMODB 120 078 
TCCWCCWL 121 079 
Footnotes TCCWINDL 122 O7A 
1. X'10' indicates Slo extend function being used Boece: ea ie 
X'20’ indicates PCI mate OErTOn being used TCCWMEAD 128 080 
2. Number of CCW slots remaining in current or TCCWMFCT 132 084 
header BEBLK HDRROQE 134 086 


3. Number of entries remaining in current [AL 
4. Operation code of CCW being translated 


Figure 36. CCW Translation Header BEBLK 
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aida Mil te, lk cline, dlimaaiti, r : ~ ne a ser aes 8 3 3 , wut” ~~ 





Before translation: 


Page-Fix List 


FXLSTNXT 


ROE 


























0 (0) 0 (0) 

4 (4) | | 10B ft | 8 (8) ae Beginning 
8 (8) | | DEB 4 | Address Address 
ite) [Te 16 (10 
16 (10) 24 (18) 


128 tao) | trey 1 


During and after translation: 


ROE CCW Translation 
0 (0) Header BEBLK 
aia) [| 108 4] ve 
gis) | | DEB ¢| BEB2XTNT 
ato [ [68 
16 (10) 
Real CCW 1 


Real CCW 4 
{TIC) 
BEBVRST 


BEBVREN 
Real CCW5 


Real CCW 9 
(TIC) 


HDRPGLK 
HDRINDL 
HDRTICL 
TCCWMFAD 


TCCWMFCT HDRRQE 






BEBLK 


BEBNXTB 


BEBVRST 


BEBVREN 
Real CCW 10 
Real CCW 11 


|_| 


Indirect Address List 
(IAL) 






Requester’s Virtual 
Channel Program 





















112 (70) 
116 (74) 
120 (78) 
124 (7C) 
128 (80) 
132 (84) 








CCW 11 

















Page-Fix List 






010 FRLSTNXT 
16 (10 
24 (18 





128 (80) 


Figure 37. CCW Translation 





Channel Error Block Table 


The optional alternate path retry routines use the channel error block table (Figure 38). 
It contains entries (Figure 39) used to keep track of the failing paths to a device. 
(Alternate path retry routines remove failing paths from contention so that retries are 
only attempted on remaining nonfailing paths.) 
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CEBTAB 


Figure 38. Channel Error Block Table 











Five 
Entries 












Dec Hex 
0 0 CEBINA CEBCHMSK CEBRQE 

Active/|n- Failing path | Address of 
active mask RQE for fail- 
indicator ing request 

Field Dec Hex 

CEBCHMSK 0001 0001 

CEBINA 0000 0000 

CEBROE 0002 0002 


Figure 39. Channel Error Block Table Entry 


Channel Status Word 


The Channel Status Word (CSW, Figure 40) indicates to a program the status of an I/O 
device, control unit, channel, and subchannel. The CSW is assigned permanently to real 
storage location 64. After an I/O interruption, the channel stores information in the 
CSW, and also during execution of the start I/O, test I/O, and halt I/O instructions. 
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Channel Table 





Dec Hex 


0 0 

Protection Ke 
4 4 
Field 


Address of Last CCW +8 
Count 

Protection Key 

*Status 


*Flags and Masks 


Flag Hex 
Field Contains Value 


Status Byte 1 X'80' 
X'40’ 

X'20' 

X‘10' 

Xx'08’ 

x'04' 

X'02' 

X'01' 

Byte 2 X'80' 
X'40' 

X'20' 

X‘'10' 

X‘08' 

X'04' 

X'02' 

X'01' 


y 


Dec 


0001 
0006 
0000 
0004 


Address of Last CCW +8 





Hex 


0001 
0006 
0000 
0004 


Means 


Attention 

Status modifier 
Control unit end 
Busy 

Channel end 
Device end 

Unit check 

Unit exception 


Program controlled interruption 


Incorrect length 
Program check 
Protection check 
Channel data check 
Channel control check 
Interface contro! check 
Chaining check 


Figure 40. Channel Status Word 


The channel table consists of entries containing address of channel search routines, 
arranged in channel number order (Figure 41). It is used when a channel becomes free 
and a channel-dependent channel search routine is needed to select requests that should 


be started next. The format of a channel table entry is shown in Figure 42. 
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IECCST 









Entry for Multiplexer Channel 
Entry for Selector Channel 1 


Entry for Selector Channel 2 








Entry for Selector Channel 6 


Figure 41. Channel Table 








Dec 


0000 
0002 


Dec Hex 
0 0 Address 
of Channel 
Search 
Routine 
Field 
Address of Channel Search 
Routine 
*Channel Mask 
Reserved 


*Flags and Masks 


Flag 


Field Contains 


Channel Mask 


Figure 42. Channel Table Entry 





Device Statistics Table 


The device statistics table contains counters that are used to keep track of the number of 


0003 


Channel 
Mask 


Hex 


0000 
0002 
0003 


Hex 

Value 
X‘80' 
X'40' 
X'20' 
X‘10' 
X‘08' 
X‘04' 
X‘02' 
X'01’ 


Reserved 





Means 


Channel 0 
Channel 1 
Channel 2 
Channel 3 
Channel 4 
Channel 5 
Channel 6 
Channel 7 


times error conditions have occurred on I/O devices. 


There is one 10-byte entry in the device statistics table for each I/O device in a system; 
in addition, there is a 10-byte control field at the beginning of the table which is used in 
locating entries to be updated (Figure 43). 


In the case of the 3400 tape devices, a 20-byte statistics table entry is allocated for each 


device in a system. 
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{ ucB 256 | ¢ ucB512| ¢ UCB 768 7FFF \ eee 
Entry for UCB 1 
Entry for UCB 2 


Entry for UCB 3 
Entry for UCB 7 


Figure 43. Device Statistics Table 














There are four general formats of device statistics table entries (Figure 44). Bytes 0 
through 7 of every entry contain as many four-bit counters as are needed to keep the 
relevant statistics for the device. Bytes 8 and 9 of each entry are work areas into which 
error routines place bit patterns indicating which counters are to be incremented. 
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0(0) 
Temporary 
Read 
Failures 


Temporary 
Write 


Failures 


a 


8(8) 
Work Area 


0(0) 
Temporary 
Read 
Failures 


4(4) 
Read/Write 
Vert. Red. 
Check 


8(8) 
Work Area 


0(0) 
Temporary 
Read 
Failures 


(1) 


Intervention 


Required 


Temporary 
Write 
Failures 


Longitudinal 
Redundancy 
Check 


Temporory 
Write 
Failures 


4(4) 51 
Serializer/ 
Unsafe Deserializer 


8(8) 
Work Area 


EDC/CRC 


9(9) 


Expansion 


Not Used 


9,0 


Feed~ 

Through 

Check 
8,1 


Not Used Not Used 


9,1 9,2 


Bus-Out 
Check 


Work Area 





Bus-Out 
Check 


Cyclic 
Redundancy 
Check 


Work Area 





Control 
Unit 
Tag Line 


Work Area 





Envelope Check 


Track in Error 


Velocity 
Check 
8,3 


Not Used 





9,3 


Unit Record Devices 


2(2) 3(3) 

Device 
Dependent 
(Sense Byte 6) 


Device 
Dependent 
(Sense Byte 7) 


Equipment Overrun 


Check 


2400/3400 Series Magnetic Tape Devices 


2(2) 


Equipment 
Check 


Data 
Converter 


Check 


Overrun 


4a Channel 


Data 
Check 


Read 
Opposite 
Recovery 


2314 Devices 


2(2) 3(3) 

Track 
Condition 
Check 


Equipment 
Check 


Overrun 


6(6) 7(7) 
Arithmetic Missing 
Logical Address 
Unit Marker 


3410 Series Magnetic Tape Devices 


MTE/LRCR 


3,1 
6(6) 


Overrun 


0,5 
10(A) 


Write TM 
Check 
5,2 


14(E) Stort 


Readback Velocity 

Data Check 

8,4 | 8,5 
18(12) Tape Unit 
Positioning 


Check 
3,6 4,0 


Backward 


Figure 44. (Part 1 of 2) Device Statistics Table Entries 
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Device Table 


EDC/CRC 


0 


Envelope Check /VRC 


2,0-7 


ear eae Cee 





Overrun 


Check 


Skew 


Check 
5,4 





3420 Series Magnetic Tape Devices 


MTE/LRCR 


3,] 
7(7) 
Write 
Trigger VRC 


C-Compare 


3,3 3,4 0,5 3,2 3,7 4,3 
} 9(9) Track in Error 10(A) 11{B} 
i Mask Bits Write TM Start Read Partial Record €xcessive Post 


Amble or TM 
Do 546 





IBG Drop Feed-Through 
While Writing Check 





13(D) 


Early Begin 
Read Back 


Spare Cheek 





52 
14(E) — 


Early End 

Read Back 

Check 
8,4 


Slow Begin 
Read Back 
Check 

8,5 


15(F) 
Slow End 
Read Back 
Check 
8,6 8,7 


Velocity Retry 





8,0 ! 8,1 
16(10) 


8,2 8,3 
~y 


17(11) 


18(12) 


| 19(13) - 





Vel. Change 
During Write 


ALU Hardware 
Error 


Bus Out 
Not Used Not Used Not Used Check 


9,0 9,1 9,2 9,3 3,6 0,2 4,0 


Backward 








Figure 44. (Part 2 of 2) Device Statistics Table Entries 





The device table (Figure 45) provides the I/O supervisor with a means for obtaining the 
addresses of certain device and queuing-option dependent routines. The format of a 
device table entry is shown in Figure 46. 


Unit Record Device 
Entries 


Magnetic Tape Device 
Entries 


\ 
! 
| 
| 
| 


Telecommunications 
Device Entries 


Graphics Device 
Entries 


Dummy Device 
Entries 


Figure 45. Device Table 
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Dec. “Hex 


0 0 DVTENQ DVTSIO 


Address of enqueue Address of start 
routine 1/O routine 


4 4 DVTTRP DVTSEN 


Address of trapcode Address of sense 
routine routine 





Field Dee Hex 

DVTENQ 0000 0000 
DVTSEN 0006 0006 
DVTSIO 0002 0002 
DVTTRP 0004 0004 


Figure 46. Device Table Entry 





Indirect Address List 


The Indirect Address List (IAL, Figure 47) contains the beginning address of the data 
areas that are not contiguous in real storage. 


The real CCW’s data address points to the IAL. Data transfer begins with the first 
address in the IAL and continues until a 2K boundary is reached. It then proceeds from 
the second address in the IAL. This process continues until the end of the data area is 
reached. 


80 OS/VS2 I/O Supervisor Logic 





DEC 


24 


120 


Field 


HEX 
00 


18 


78 


IALCHAIN 


IDA 1 
IDA 2 
IDA 3 
IDA 4 
IDA 5 
IDA 6 
IDA 7 
IDA 8 
IDA 9 
IDA 10 
IDA 11 
IDA 12 
IDA 13 
IDA 14 
IDA 15 
IDA 16 


Figure 47. Indirect Address List 





Logical Channel Word 


IALCHAIN 


Chain 
pointer 


IDA 1 


Indirect 
address 
1 


IDA 2 IDA 3 


Indirect Indirect 
address address 
2 


3 


IDA 4 


Indirect 
address 
4 





IDA 5 


Indirect 
address 






DEC 


0000 
0004 
0008 
0012 
0016 
0020 
0024 
0028 
0032 
0036 
0040 
0044 
0048 
0052 
0056 
0060 
0064 


IDA 30 


Indirect 
address 
30 


HEX 


0000 
0004 
0008 
000C 
0010 
0014 
0018 
001C 
0020 
0024 
0028 
002C 
0030 
0034 
0038 
003C 
0040 









IDA 31 


Indirect 
address 
31 
















IDA 32 


Indirect 
address 
32 








IDA 33 


Indirect 
address 

















33 


HEX 


0044 
0048 
004C 
0050 
0054 
0058 
005C 
0060 
0064 
0068 
006C 
0070 
0074 
0078 
007C 
0080 
0084 


The Logical Channel Word (LCH, Figure 48) is an 8-byte data area which is used 
primarily to define the bounds of a logical channel queue. There is one logical channel 
word for each logical channel queue. All of the logical channel words together make up a 
table called the logical channel table. The format of a logical channel word is shown in 
Figure 49. 
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LCHTAB 
IECILCH 

















re 


| a 
res Channel Table Logical Channel Queue 





ee 


Figure 48. Logical Channel Queues 





Dec Hex 
0 0 LCHFTS LCHLTS 
Address of first RQE | Address of last ROE 
in logical channel in logical channel 
queue queue 
4 4 
LCHSRH LCHTCH 
Work area Address of test chan- 
nel routine 
Field Dec Hex 


LCHFTS 0000 0000 
LCHLTS 0002 0002 
LCHSRH 0004 0004 
LCHTCH 0006 0006 


Figure 49. Logical Channel Word 
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Page Fix List 
( The Page Fix List (PGFX), built by the page fix routine, contains the address of pages 
that should not be removed from real storage through normal paging operations. Entries 
are made for control blocks and up to five appendages. The user page fix appendage, if 
provided, can also make entries into the list. Figure 50 shows the format of the page fix 
list. 
DEC 
. 9) 
FXLSTCHN 
FXLSTNXT Pointer to 
Chain pointer next available entry 
7 g 
Start 
address Address 
16 
Fix Entry 2 
24 
128 80 
Fix Entry 16 
Field DEC HEX Options and Flags 
Fix Entry 1 0008 0008 Options—bits 1-7 valid on first entry only 
Fix Entry 2 0016 0010 
Fix Entry 3 0024 0018 
Fix Entry 4 0032 0020 ex wieans 
Fix Entry 5 0040 0028 X'80° Continuation flag 
Fix Entry 6 0048 0030 X'40' Fix request 
Fix Entry 7 0056 0038 X‘20' Free request 
Fix Entry 8 0064 0040 Xx'10' Page load to be done 
Fix Entry 9 0072 0048 X'08’ Release option 
Fix Entry 10 0080 0050 X’02' Long term fix 
Fix Entry 11 0088 0058 
Fix Entry 12 0096 0060 Flags—valid on End Address entry 
Fix Entry 13 0104 0068 
Fix Entry 14 0112 0070 Hex Means 
Fix Entry 15 0120 0078 ee =o 
: Fix Entry 16 0128 0080 X’S0" Last entry 
FXLSTCHN 0000 0000 x'40 Null entry 
i FXLSTNXT 0004 0004 X‘20’ Real address option for fix 


X‘10' Error flag 
X‘08' Suspend option for fix 


Figure 50. Page Fix List 
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Program Controlled Interrupt Modify Parameter List 


A Program Control Interrupt (PCI) appendage builds the PCI modify parameter list to 
define to the I/O interruption supervisor the CC Ws that were modified during the 
execution of the PCI appendage. The I/O interruption supervisor then modifies the real 
channel program in the SQA according to the changes made by the PCI appendage. 


Figure 51 shows the format of an entry in the list. 


Address of Virtual CCW 
. oo 3 Bytes ad 


Figure 51. PCI Modify Parameter List Entry 


Program Status Word 


The Program Status Word (PSW, Figure 52) is a two-way communication link between a 
CPU and a program. All PSWs occupy permanently assigned virtual storage locations. 
The PSWs to which the I/O supervisor refers are: 


Name 

SVC Old PSW 
1/O Old PSW 
1/O New PSW 
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Location 
32(20) 
56(38) 
120(78) 


Symbolic Name 
SVCOPSW 
IOPSWO 
IONPSW 


2 





Dec Hex 














0 0 Protection Condition Code 
OROOATIE Key and and Program 
1MWP Mask 
4 4 
Instruction Address 
Field Dec Hex 
* TMWP 0001 0001 
1 Condition Code 0002 0002 
Instruction Address 0004 0004 
*Program Mask 0002 0002 
Protection Key 0001 0001 
*OROOATIE 0000 0000 


*Flags and Masks 





Flag Hex 
Field Contains Value Means 
1MWP X'08’ EC mode bit must be set to 1. 
x'04’ Machine check interruptions can occur. 
x'02' The CPU is in the wait state. 
x'01' The CPU is in the problem state. 
x‘00' The CPU is in the supervisor state. 
OROOATIE X'80' Enabled for monitor calls 
X'40' Enabled for program event recording 
x‘20' 0 
X‘10' 0 
X'08' 31-bit addressing 
x'04' Dynamic address translation 
x'02' Enabled for I/O interruptions 
x'01' Enabled for external interruptions 
Program Mask X'08' Fixed point overflow 
x‘04' Decimal overflow 
x‘02' Exponent underflow 
x'01' Significance 


Figure 52. Program Status Word 
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Request Queue Element 


The Request Queue Element (RQE, Figure 53) contains the address of the major control 
blocks needed to process a request for I/O activity. 


During system generation, a number of RQEs are created to equal the maximum number 
of a new I/O operations that can be processed simultaneously by the new operating 
system. Except for the last, each of these unassigned RQEs contains only the address of 
the next ROE; the last ROE contains ones in its address, or link field. The chain of 
unassigned RQEs is called a freelist. 


When a request for I/O activity is received by the I/O supervisor, it removes one RQE 
from the freelist, and the RQE is initialized with the addresses of control blocks needed 
to process the request. 


When a request cannot be started immediately, the RQE is placed into a logical channel 
queue. The ROE remains in the queue until the needed device and a path to the device 
becomes available and, optionally, until high-priority requests for the same device and 
path are satisfied. 


During the I/O activity, the address of the RQE is in the UCBLTS field of the UCB. An 
RQE is returned to the freelist when all I/O activity associated with the request it 
represents is completed. 


All of the RQEs are located contiguously in real storage and are sometimes referred to as 
the request queue element table. The term table is used loosely, however, because access 
is gained to the specific RQEs by way of pointers and not by offsets from the beginning 
of the table. 


86 OS/VS2 I/O Supervisor Logic 


“ps 





Dec = Hex 


TSTLNK 


TSTUCB 


Address of next Address of UCB 


a) 0 
RQE 

* 4 |TsTTcB 
Task ID 

8 8 |TSTPR 


Priority 


ie “OC. VISTKEY 


Requester’s 


TSTIOB 
Address of |OB 


TSTDEB 
Address of DEB 


TSTTCBAD 


Address of TCB 


TSTHDR 


CCW Translation flags; address of page-fix 
list before CCW translation and address of 
header BEBLK during and after CCW 

translation. 





Hex 


0009 
0010 
0005 
000C 
0000 
0008 
0004 
000D 


Protection 
Key 
16 10 
Field Dec 
TSTDEB 0009 
*TSTHDR 0016 
TSTIOB 0005 
TSTKEY 0012 
TSTLNK 0000 
TSTPR 0008 
TSTTCB 0004 
TSTTCBAD 0013 
TSTUCB 0002 


*Flags and Masks 


Flag 

Field Contains 

TSTHDR CCW 
Translation 
Flags 


0002 


Hex 
Value 


X‘80' 


X‘40’ 
X‘20' 
X‘10' 
X‘08' 
X'04' 
X'02 


X‘01' 


Means 


Fixed requester 

SVC 114 

Virtual requester 

Nonpageable requester 

Page supervisor is requester 
Translation in progress 
Translation complete 

Used by an SVC 114 request to 
re-execute a channel program out 
of the channel-end appendage 
following error recovery. 

RQE has been queued on LCH 


Figure 53. Request Queue Element 
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Start Input/Output Extend Parameter List 


A Start Input/Output (SIO) appendage (Figure 54) builds the SIO extend parameter list J 
to define to the EXCP supervisor all of the CCWs that might be used in an I/O 

operation. The EXCP supervisor then translates all of the CCWs referenced on the list 

before issuing the start I/O instruction to the 1/O device. Each entry in the list has the 

following format. 


e If bit O of byte 0 of the count field is a 0, the count field specifies the number of 
contiguous CCWs in the string to be translated. The EXCP supervisor then translates 
the CCW string to real addresses. If the first CCW in the string has already been 
translated the EXCP supervisor assumes the entire string has been translated and ‘ 
bypasses the entry. 


e If bit O of byte 0 of the count field is a 1, the count field specifies the maximum 
number of indirect address words required for the CCW. This implies that the CCW 
data address or length can change. The count is the maximum CCW data length to be 
used divided by 2K. Such entries must refer to CC Ws within the CCW strings 
specified in the list. The EXCP supervisor constructs a corresponding real CCW with 
the indirect address word bit, bit 37(25), set to one and creates an indirect address list 
whether or not it is required. 


Address of a Virtual CCW 
. oe 3 Bytes el 


Figure 54. SIO Extend Parameter List wi 


Ni 


Volume Statistics Table 


The volume statistics table contains information and statistics pertaining to volumes on 
2400/3400 series magnetic tape devices. It contains one entry for each 2400 and 3400 
magnetic tape device in a system. 


The address of each entry is contained in the UCB for the device containing the volume. 

The entries may or may not be contiguous. The format of each entry varies according to 

the options selected at system generation time. If neither the error volume analysis 

(EVA) nor the error statistics by volume (ESV) options are selected, an entry will 

consist of only the first 8 bytes shown in Figure 55. If only EVA was specified, each 

entry will consist of the first 16 bytes whown. If ESV or both ESV and EVA were 

specified, the length of each entry will be the full 24 bytes. ° 


For 3400 series magnetic-tape units, the length of each entry is always 24 bytes. 
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nner N,Q), 


For 3400 series magnetic-tape units, the length of each entry is always 24 bytes. 


Statistics Update 


Permanent 
Write 
Errors 


CCW for Read-Opposite Recovery 


Temporary Temporary 
Read Write 
Errors Errors 


Read Error Write Error 
Threshold Threshold 


Reserved* Erase Gaps 


*'Mode Set’ when tape device has extended sense. 


0 0 
8 8 
Mask 
16 10 
Permanent 
Read 
Errors 
Field 
CCW for Read-Opposite 
Recovery 
Cleaner Actions 
Erase Gaps 


Noise Blocks 
Permanent Read Errors 
Permanent Write Errors 


Dec 


0000 
0022 
0020 
0018 
0016 
0017 


Read Error Threshold 0010 
0000 Reserved 0019 
0016 Start 1/O 0014 
0014 Statistics Update Mask 0008 
0012 Temporary Read Errors 0012 
0010 Temporary Write Errors 0013 
0011 Write Error Threshold 0011 


Figure 55. Volume Statistics Table Entry 


Start I/O 


Cleaner Actions 





Hex 


000A 
0013 
OQOOE 
0008 
oooc 
000D 
000B 
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DIAGNOSTIC AIDS 


This section contains information to help you interpret the program listings and diagnose 
program failures. 


General Register Assignments 


Figure 56 shows the general register assignments for the resident parts of the I/O 
supervisor (EXCP Supervisor, [/O Interruption Supervisor, and Error EXCP 
Supervisor). Assignments for other routines can be found in the prologs to the routine 


listings. 


Register 
0 


eamah 


oOo Oo HNO HO A FP FP WY WY WN 


13 

j 13 
14 

15 


Symbol 
REGO 
TSTREG 
IOBREG 
BASREG3 
DEBREG 
BASREGS 
DCBREG 
BASREG 
BASREG4 
UAREG 
UCBREG 
LNKGRI 


ICREG 
HDRREG 


TCCWREG 


WKREGI 
WKREG2 
PRFXREG 


WKREG3 
LINKRG3 


BEBREG 
LCHREG 
LNKRG2 
APBSRG 


Assignment 

Temporary storage 

RQE Address (For assigned but not-queued RQE) 
IOB address 

Base register for translator 

DEB address 

Third base register 

DCB address 

Base register for [/O supervisor 
Second base register for translator 
Channel and unit address 

UCB address 

Second Base register 


Work register 
Pointer to CCW translation header BEBLK 
Pointer to CCW translation header BEBLK 


Work register 
Work register 
Prefix storage address register 


Spare work/linkage register 


Address of current BEBLK 
Logical channel word address 
Linkage register 


Used for calculating addresses of appendages to be invoked and used as a 
base register for the appendages. 


Figure 56. General Register Assignments 


System Completion Codes 


When a task is terminated abnormally, a three-digit system completion code printed in 
the storage dump generally indicates why. See OS/VS Message Library: VS2 System 
Codes for a complete list of system completion codes. The meanings of the codes 
produced when abnormal termination results from trouble during input/output 
processing are shown in Figure 57. 
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Code 
200 


300 


400 


500 


600 


700 


800 


900 


A00 


C00 


DO00 


Explanation 


An error was detected during EXCP processing; the 
storage protection key of the IOB, ECB, or DCB was not 
the same as the protection key field in the DEB. 


An error was detected when an I/O operation was 
requested; the storage protection key of the DEB was 
not zero or the DEB validity check routine IFGDEBCK 
returned to IOS with a nonzero return code. 


The control block chain between the IOB, DCB, DEB, 
and UCB was invalid. The control program found that 
one of the blocks was incorrectly modified or built. 


An unexpected program interruption occurred during 
processing of IOS. Note that the program interruption 
can be due to a page exception. 


An SVC 114 was issued with one of the following 
conditions: 


e The ‘SVC114 authorization’ bit was not set in the 
DEB. 

¢« The protection key was not zero. 

e The request was not issued in supervisor state. 

« The authorization bit was not set in the JSCB. 


A program check occurred in a supervisor service 
routine called by IOS. 


An error occurred when IOS attempted to f1x a page for 
this EXCP request. 


A program check occurred in a user appendage or an 
attention routine. 


In translating CCWs out of the PCI appendage, IOS 
found one of the following: 


e A buffer or channel program area had not been fixed. 
¢« Aninvalid [AL entry in the SIO extent list. 


Too many entries were specified by the page fix 
appendage in its page fix list. 


A page which was referenced within the control blocks, 
channel program, user page-fix list, or an appendage of 
IOS which was not within the user's region, LSQA, 
nucleus, SQA, or LPA. 


Figure 57. System Completion Codes for I/O Operations 
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Comments 


This system completion code will result if a program 
check occurs while the DCB, ECB, or IOB ts being 
loaded for IOS EXCP validity checking. Typical causes 
are premature freeing or overrunning of control blocks. 
If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0, 64, 84, and 92 in the IOS problem 
determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0 and 64 in the IOS problem determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0 and 64 in the IOS problem determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0, 64, 84, 92, and 96 in the IOS problem 
determination area. 


If an abnormal termination dump is available, see 
“Problem Determination Area” for the meaning of 
offset 0 in the IOS problem determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0, 64, 84, and 92 in the IOS problem 
determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0, 64, 84, and 212 in the IOS problem 
determination area. 


If an abnormal termination dump is available, see 
“Problem Determination Area” for the meaning of 
offsets 0, 64, 84, and 92 in the IOS problem 
determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0 and 64 in the IOS problem determination area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0, 64, and 84 in the IOS problem determination 
area. 


If an abnormal termination dump is available, see 
‘Problem Determination Area” for the meaning of 
offsets 0, 64, 84, and 212 in the IOS problem 
determination area. 





oh 


Problem Determination Area 


If an abnormal termination dump is available, the TCB field (TCBIOSAB) at offset 192 
will contain a pointer to the IOS problem determination area. The format of this area is: 


Offset 

Dec Hex 
0 0 

64 40 
84 54 
92 5C 
96 60 
212 D4 


Field Description, Contents, Meaning 


Registers at the time of error 

Contents of the RQE 

Program check PSW at the time of the program check, or first 
page fix list if this is an ABEND 800, COO, or DOO. 

ILC and interruption code 

Only meaningful on page faults. This field contains the address 
causing the last page fault. 

Second page fix list if it exists. 
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Patch Area at IECINT 


At IECINT is a 17-word storage area that can be used for diagnostic work. Since its 
location is not standard but differs for each system, refer to the address constant at label 
IOSORG for the true address. 





Generalized Trace Facility 


The Generalized Trace Facility (GTF) provides a method of tracing program events and 

recording information about these events. The trace records that are generated by GTF ‘ 
are stored internally in a table or recorded externally on a data set that becomes input to 

the AMDPRDMP service aid program. AMDPRDMP edits and formats the trace records 

as specified by an EDIT control statement. » 


The I/O supervisor interfaces with GTF when it is optioned by using monitor call 
instructions (GTF hooks). Figure 58 shows the location of the GTF hooks and the 
information that is traced. 


More information about GTF can be obtained from the following publications: 
OS/VS Service Aids 
OS/VS2 Debugging Guide 
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After label 
INTOO1C 


After labels 
INTOO1 and 
INTOOA 


After label 
XCP110D 


After label 
INTO24C 


Detects the occurrence 
of an 1/O interrupt with 
an associated UCB. 
(Normal |/O interrupt) 


Detects the occurrence 


of an 1/O interrupt with- 


out an associated UCB. 


Detects the occurrence 
of SIOs in the SIO 
subroutine, 


Detects an |/O interrupt 
with PCI status. 


Figure 58. GTF Interfaces 


R7 - UCB address 
R10 - Real CCW address from the 
CSW if an ROE exists for 


this request. 


R10 - Zero if no ROE exists. 


R1 - RQE address, 
R6 - Device address. 


R10 - SIO condition code in low 
order byte. 


R7 - UCB address. 


R10 - Real CCW address+8 





1/O Old PSW 

CSW (Contains the virtual CCW 
address+8 if it was a virtual 
request.) 

RQE 

JOBNAME 

DDNAME 

Sense bytes 0 - 3. 

|/O interrupt code. 

Real CCW addresst8. 

TCB address. 


1/0 Old PSW 

CSW (Contains the real CCW 
address.) 

1/O interrupt code. 


CSW (Contains real CCW address) 

CAW (Contains real CCW address) 

RQE 

JOBNAME 

TCB address. 

SIO condition code. 

Device address. 

Virtual address of the virtual chan- 
nel program, 


1/0 Old PSW 

CSW 

RQE 

JOBNAME 
DDNAME 

Sense bytes 0-3. 
Real CCW address. 
1/O interrupt code. 
TCB address, 
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APPENDIX A: SUPPORTING SVC ROUTINES 
The SVC routines described in this appendix are not generally used during normal 
processing of requests for I/O operations. They do, however, provide users with a 


capability for referring to, obtaining, and changing some of the data used in processing 
the I/O requests. 


Purge Routine (SVC 16) 


» The Purge routine stops the processing of I/O requests by removing request queue 
elements (RQEs) from queues. Depending upon the options specified in a parameter list 
which is provided as input (Figure 59), the Purge routine can remove RQEs from: 


e A logical channel queue 

e The supervisor’s request block queues 

e The supervisor’s asynchronous exit queue 
e The DDR wait queue 


The Purge routine can remove the elements representing all requests for a particular data 
set or task. The method to be used is indicated in the seventh bit of the options field in 
the parameter list. The general flow of control within the Purge routine is shown in 
Figure 62. The PURGE macro instruction is described in OS/VS Data Management 
Ue System Programmers. 


0(0) 
PRGOPT PRGDEB 
Purge Options Address of Data Extent Block 


4(4) 5(5) 


PRGCOD PRGTCB 
Completion Code Address of Task Control Block 











8(8) 












PRGCTR 
Quiesce Count 


PRGCHN 
Address of First Link in Chain 








13 (0D) 


* PRGFLG PRGQPL 
Address of Qulesce I/O Parameter List 







Figure 59. Purge Routine Parameter List 





si Removing Elements From Logical Channel Queues 


If all requests for a particular data set are to be purged, the Purge routine examines the 

¢ data extent block (DEB) for the data set, and removes all RQEs from the logical channel 
queue for the device or devices whose unit control block (UCB) addresses are contained 
in the DEB. When an active shared device is allocated with a purged request, the I/O 
supervisor sets the UCB’s HIO flag to issue a RELEASE to the device if its UCB reserve 
count field is zero. 


When the elements for all requests associated with a particular task are to be purged, the 
Purge routine scans the entire request element table to locate and remove the RQEs for 
the task. 
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Purge Routine Parameter List 
Bytes and Field 


Offset Alignment Name Field Description, Contents, Meaning 
0(0) 1 PRGOPT Purge options. 
Oho see Purge request queue elements for all 


entries in the data extent block (DEB) 
chain, starting with the DEB whose 
address is in PRGDEB. 


| eneree Purge only the request queue element for the DEB 
whose address is in PRGDEB. 

S| ae Do not post the event control blocks for the 
purged request queue elements. 

a eee Post the event control blocks for the purged 


RQEs. (A X°48’ completion code is used.) 

Os aus Allow the activity to quiesce. 

eee Halt the 1/O activity. (The effect of the Halt 
I/O instruction is simulated if the operation 
is a seek.) 
Purge all requests. 

sue vend Purge only related requests. 

sean Os, Normal purge. 

om Lies Purge TCB list. 

. 0.. Purge the asynchronous exit queue, the request 
block queue, the logical channel queue, and the 
DDR wait queue. 

Ps ee Purge the asynchronous exit queue, the request 
asynchronous exit queue removing only RQEs for 
requests in error, and the DDR wait queue. 
Bypass the request blocks. 

= ol, Purge by data extent block. 
me Purge by task control block. When this bit is on, 


the setting of bit 0 is ignored. 
ics Xx Not used. 
11) 3 PRGDEB Address of data extent block. 
4(4) 1 PRGCOD Purge routine completion code. 
5(5) .3 PRGTCB Address of task control block. 
8(8) | PRGCTR Quiesce count. The number of active request 


queue elements for which I/O activity has not 
yet been completed. 


9(9) “3 PRGCHN Address of the first link in the chain of IOBs 
which are purged. The first link can be located 
in the user’s area, or in the DEBUSPRG field of 
the DEB. It will point to the first LOB in 
the chain. The last [OB in the chain will 
contain ones in the low-order byte of the restart 
address (IOBRST) field. 


12(C) 1 PRGFLG Purge flags. 
Oise weed Purge entry. 
| aor Wait entry. 
iO siieus Return before wait. 
1 Purge and wait. 
my | ree DEQ before WAIT. 
sel aude No DEQ before WAIT (set before system DEB 
purged). 
A ee Not used. 
sas Mah Not used. 
ray oe Not used. 
ie Not used. 
sae dace x Not used, 
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ee rnmmemessmee rr  aa 
Temporary 






i 
| 
ee ee eee 
ae ae a Ee Sate eee Ny ee ee ee ee 
. Field for Last Entry is X '80 
Figure 60. Quiesce I/O Parameter List 
Quiesce I/O Parameter List (TSO Only) 
Bytes and 
Offset Alignment Field Description 
0(0) 1 Temporary count field. 
101) .3 Not used. 
8(8) 8 First parameter list entry. 
Byte Description 
0 Not used. 
1-3 IOB chain field. 
4 QPL flags. 
Oin:: saz More entries follow. 
Lae Stee Last entry. 
.0.. ..... Not acurrent entry. 
.l.. .... Current entry. 
5-7 Address of TCB to be purged. 


Additional parameter list entries may be present. 


Removing Elements From the Supervisor’s Request Block Queues 


To remove elements from a supervisor request block queue, the Purge routine obtains the 
address of the first request block in the queue from the TCB whose address is passed as 
input. When no TCB address is passed, it assumes that the current TCB is the input 
TCB. The Purge routine then scans the entire request block queue. For each system 
interruption request block (SIRB) and interruption request block (IRB) in the queue, the 
Purge routine removes the RQEs containing a DEB address which matches the input 
DEB address (for a purge by data set); or removes the RQEs containing a TCB address 
which matches the address of the input TCB (for a purge by task). 


Descriptions of the SIRB and IRB are contained in OS/VS2 System Data Areas. 


Removing Elements From the Supervisor’s Asynchronous Exit Queues 


To remove request queue elements from the supervisor’s asynchronous exit queue, the 
Purge routine first obtains the address of the queue from the communications vector 
table. It then scans the entire asynchronous exit queue, removing every RQE containing 
a DEB address which matches the input DEB address (for a purge by data set); or 
removing every RQE containing a TCB address which matches the address of the input 
TCB (for a purge by task). When a TCB address is not passed as input for a purge by 
task request, the Purge routine uses the current TCB for the matches. 


The communications vector table is described in OS/VS2 System Data Areas. 
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The IOB Chain 





The Purge routine links the IOBs for purged requests together in a chain beginning at the 


address specified in the third word of the Purge routine parameter list (Figure 61). A 
RESTORE macro instruction could then be used to restart the requests. The Purge 
routine does not create an IOB chain when the halt I/O option is specified with the 
purge-by-TCB option. 


From User of SVC 16 
Instruction via Supervisor 
SVC Interruption Handlers 


(82) TCBOO0O02A 


Turn on 
ABEND Entry 


Indicator 





AEQPURG 


Find RQE to be 
Purged from 
Asynchronous 
Exit Queue 


All ROQEs 
Checked 













Purge 
Request Block 
Queues 






Get Address of IRB 
or SIRB From TCB, 
Get Address of ROE 
from IRB or SIRB 







All RQEs 
Checked 




















Purge 
by Data Set 
or by Task 


TCBOO4 







Get Address of 
RQE from RQE 
Tabiec 





POSTCHK 





Quiesce 
Count = 0 





Post Completion 
Code in Request- 
er’s ECB 





Return to Supervisor 













Data Set 


All ROEs Checked 


Clear Quiesce Purge DDR Wait 


Counter, Com- 





pletion Code Queue 
All RQEs 
Checked 
PURGCHK 
VALCHK 





For Purge by Data 
Set Option, Match 
DEB Address in 
RQE Against Input 
DEB Address 


Match DEQUE 


—— 
Dequeue ROE 
For Purge by Task 
Option, Match TCB 
Identifier for ROE 
Against Input TCB 
Identifier 
More 
ae UCBPRG 
DEBPURG Extent VALCHK 

















Field 


ee 


















Using Index in UCB, 
Get Address of 
Logical Channel 
Word. Scan RQEs in 
Queue. 


Using Input DEB 
Address, Get UCB 
Address from DEBs 
Extent Fieid 


Match DEB Address 
in RQE with Input 
DEB Address. 


Match 




























Scan RQEs. Match 
TCB Identifier for 
RQE with Input TCB 
Identifier. Remove 
RQE from Queue. 


DEQUE 


Dequeuve ROE 


DEQUE 


Dequeue ROE 









Remove RQE from 
Queue, Return to 
Freelist 


Wait for 


Activity to 
Stop 








Virtual 
1/O Request 


CPU Control Will Re- 
turn to the 1/O Super- 
visor Untit it Posts the 
ECB Being Waited Upon. 
At That Time, This 
Routine will be Re- 
Entered. 






ABEND No 






Trans- 
lation in 
Progress 








Update Quiesce 


Counters by 
One 






Unfix lOS Pages 
and Freemain all 

Gotten Core fram 
SQA 






Figure 61. Purge Routine 
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C 


C 


The Quiesce Option 


When the quiesce option is specified, the Purge routine increments two counters by one 
for each I/O request awaiting completion: 


e A main purge counter in the parameter list 
e A secondary counter in each effected DEB 


Thus, if there is a request to quiesce activity for a specific data set, both counters will 
have a count of one. If there is a request to quiesce the activity on all data sets of a task, 
however, there will be counts in each DEB counter reflecting the number of 


not-yet-completed requests for the data sets, and there will be a total count in the main 
counter. 


Every time the Purge routine increments a counter, it places a pointer to the purge 
parameter list into the ‘address of purge parameter list’ field of the DEB. Also, after it 


has put the total count in the main counter, the Purge routine issues a WAIT macro 
instruction. 


When I/O activity has been completed for a request, the I/O interruption supervisor will 
enter its Quiesce Complete subroutine (entry point PRGCOMA or PRGCOMB) if it 
finds an address in the ‘address of purge parameter list’ field of the DEB for the newly 
completed activity. The Quiesce Complete subroutine decrements both the main and 
secondary counters by one. If a DEB secondary counter is zeroed, the ‘address of purge 





Purge Routine Parameter List User-Specified Location 


25(19) 
IOBRST 


0(0) 1(1) 
PRGOPT | PRGDEB 
4(4) 5(5) 
PRGCOD } PRGTCB 
8(8) 9(9) 
PRGCTR | PRGCHN 
The Purge routine places 
the address of the first 
IOB in the chain into the 
user-specified location. 
Thereafter, it chains the 
IOBs by means of a field 
at offset 25 (dec.) and 


uses ones to indicate the 
last |OB of the chain. 


Input/Output Block 


25(19) 
IOBRST 





Input/Output Block 


25(19) 
lOBRST 





Figure 62. Purge Routine IOB Chain 
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parameter list’ field in the DEB is also zeroed. When the main counter in the parameter 
list is zeroed, indicating the quiesce is complete, the Quiesce Complete subroutine posts | 

the purge ECB. If the main counter is not zeroed, the Quiesce Complete subroutine - 
return control to the I/O interruption supervisor. 


Purging a Virtual I/O Request 


When purging a virtual I/O request, the CCW translation status must be considered 
before returning the RQE to the freelist. If translation is finished, the purge routine links 
to the I/O supervisor to unfix the pages and to return the SQA space that was gotten for 
this request to IOS. The RQE is then returned to the freelist. 


If CCW translation is not finished, a paging I/O operation is in progress. In this case, the 

RQE is quiesced and the address of the purge parameter list is placed into the DEB. The 

purge routine then processes the next RQE. When the paging I/O operation is finished, aig 
the CCW translator examines the DEB to see if the RQE it was translating was purged. 

If it was, it completes the purge as stated in the previous paragraph. 


Restore Routine (SVC 17) 


The Restore routine restarts the processing of requests that have been dequeued by 
means of the Purge routine if Halt I/O option was not specified with the purge-by-task 
option. Using a pointer to the first IOB in a chain of IOBs that it receives as input in 
register 1, the Restore routine issues an SVC O or an SVC 114 for each IOB in the chain, 
depending on the type of I/O operation purged. 


The RESTORE macro instruction is described in OS/VS Data Management for 
System Programmers. 


DEVTYPE Routine (SVC 24) 


The DEVTYPE routine supplies information about the characteristics of I/O devices. 
The instructions in the expansion of the Locate Device Characteristics (DEVT YPE) 
macro instruction place parameters into general registers, and the DEVTYPE routine 
uses the parameters to identify the device and to find where it should place the output 
information. 


The DEVTYPE macro instruction is described in the publication OS/VS Data 
Management for System Programmers. 


Using the DD name it receives as input, the DEVTYPE routine finds the corresponding 

task input/output table (TIOT) entry, and uses it to locate the proper UCB. The 

DEVTYPE routine then obtains the device type field from the UCB and places it into 

the first word of the output area. ” 


If the DEVTAB parameter was not specified, the output area will contain two words of 
information. The DEVTYPE routine determines the maximum block size from the device 
charactersitics table (if the device is a direct-access device) or from internal constants, 
and moves it to the second word of the output area. 


If the DEVTAB parameter was specified in the DEVTYPE macro instruction, and the 
device is a direct-access device, the DEVTYPE routine will provide three additional 
words of information. The DEVTYPE routine locates the device characteristics table via 
the communication vector table, moves the appropriate entry into the low-order three 
words of the output area, and moves the blocksize field to the second word of the output 


area. ) 
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Before relinquishing control, the DEVTYPE routine places a return code into register 15. 
A return code of 00 indicates that the request was completed successfully. A return code 
of 04 indicates one of the following conditions: 


e No output area specified: The area parameter was not included in the DEVTYPE 
macro instruction. 


e DD name not found: No TIOT entry exists that corresponds to the DD name supplied. 


e Invalid UCB unit type field: The UCB unit type field (byte 4 of the device code 
field) does not specify a direct-access, tape, or unit record device. 


A return code of 08 indicates that an invalid output area address was specified. 


IOHALT Routine (SVC 33) 


The IOHALT routine stops all activity on the teleprocessing device whose unit control 
block (UCB) address is passed in register 1. It does not stop activity on 
nonteleprocessing devices. 


The IOHALT routine checks the validity of the UCB address it receives by matching it 
against the UCB addresses in the UCB lookup table. If the address passed is valid and if 
the device to be stopped is a teleprocessing device, the IOHALT routine gives control to 
the resident Halt I/O routine (entry point IECIHIO), which issues a Halt I/O instruction 
and returns. The IOHALT routine places a completion code into register 15 before 
relinquishing control: 


Code (Hex.) Meaning 

00 The device was stopped. 

04 The device is not running. 

08 The device was not stopped because it is not a 


teleprocessing device. 


OC The device was not stopped because the 
UCB address was invalid. 


VOLSTAT Routine (SVC 91) 


The first load module of the VOLSTAT routine constructs error-statistics-by-volume 
(ESV) records and, depending upon what was specified during system generation, writes 
them on either the console output device or the system management facilities 
(SYS1.MAN) data set. 


Data management Close and EOV routines pass control to the VOLSTAT routine when 
the volume is demounted. 


The VOLSTAT routine obtains error statistics from the volume statistics table, and 
obtains other identifying information from the UCB, DCB, or JFCB and DEB. After 
writing an ESV record, the VOLSTAT routine clears the counters in the volume statistics 
table and returns control to the Close or EOV routine. 


The second load module is called to read the buffered log data of an IBM 2305 Fixed 
Head Storage, IBM 3330 Disk Storage, or IBM 3333 Disk Storage and Control. This 
load module is activated when a new volume is mounted or when the operator enters a 
HALT EOD command. 
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TCB EXCP (SVC 92) (TSO only) 


The TCB EXCP routine allows the user to specify, in register 0, a TCB address 
associated with the IOB address passed in register 1. The specified TCB will be the one 
associated with the RQE. 


Extended SVC Routine (SVC 109) 


The Extended SVC routine is used by the Task Termination routine to ensure that a task 
cannot leave outstanding I/O requests. 


The routine checks each RQE in the system, unless outstanding teleprocessing-based I/O 
is found. If an RQE is assigned, the TCB is checked for an equal condition. If the equal 
condition is found, the UCB is checked for a teleprocessing-device indicator. If the 
device indicator is found, an ABEND is issued. 


If there are no RQEs assigned for the terminating task, an SVC 3 is issued. If the 
assigned RQEs do not represent the teleprocessing-associated I/O, the Extended SVC 
routine issues the PURGE macro to call the Purge routine (SVC 16). If an IOB chain for 
the Restore routine (SVC 17) results, an ABEND is issued. If no IOB chain is built, an 
SVC 3 is issued. 
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APPENDIX B: ALTERNATE PATH RETRY 


In systems with the alternate path selective retry option, when a device can be reached 
by more than one path and there is a failure of one of the paths, the others are 
automatically tried, one by one, either until the operation is successful or until the error is 
declared permanent. In addition, the operator is provided with a ‘vary path’ command by 
which he may add or remove paths to a device. The two alternate path retry functions 
are called ‘selective retry’ and ‘vary path,’ respectively. 


The Selective Retry Function 


Without alternate path retry, each time there is a channel failure and the Test Channel 
routine is entered preparatory to retrying the I/O activity, it selects a path for the retry 
from the alternate path table. The selected path may or may not be the failing channel, 
because the alternate path table is not changed after I/O errors. 


With alternate path retry, the Test Channel routine refers to the path mask field of the 
unit control block for the requested device rather than to the alternate path table, and 
failing paths are removed from the path mask when channel errors occur. 


Error recovery routines pass control to the Alternate Path Retry routine before 
attempting each restart. The Alternate Path Retry routine obtains and saves the original 
path mask from the requested device’s unit control block in a table called the channel 
error block table. It then turns off the failing channel’s bit in the channel mask field of 
the unit control block and returns control to the I/O error routine, which begins the retry 
attempts. 


To prevent a situation where all paths would become unavailable, the Alternate Path 
Retry routine restores the original path mask to the unit control block if the last available 
path is about to be used. The I/O error routine may then initiate the retry cycle again, 
depending upon whether the specified number of retries has been reached. 


The Vary Path Function 


When the operator issues any command, job management command processing routines 
are entered. For the ‘vary path’ command, the Vary Path Command Processor routine is 
given control (Figure 63). It adds or removes paths to a device by setting bits in the path 
mask table of a unit control block on or off. 
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Figure 63. Vary Path Command Processing 





Appendix B: Alternate Path Retry 105 





APPENDIX C: DIRECT-ACCESS VOLUME 
7 VERIFICATION 


If the direct-access volume verification (DAVV) option is selected during system 
generation, the input/output supervisor checks the serial numbers of newly mounted 
volumes against serial numbers in the unit control blocks (UCBs) for the devices 
containing the volumes. It issues messages to the operator when the wrong volumes have 
been mounted. 


When an operator readies a device after mounting a volume, he causes an I/O 
interruption and entry to the I/O interruption supervisor. If the UCB for that device 
contains a volume serial number, the I/O interruption supervisor sets a flag in the UCB 
for the device to indicate that volume verification is to be performed. The next time there 
is a request for activity on the device, the I/O supervisor, having checked the flag, 
schedules module IGEOO25E. When IGE0025E gains control, it checks the flag in the 
UCB to determine if volume verification is required. If it is, control is transferred to 
module IGE0125E, the first module of the two-module volume verification routine. 


Module IGE0125E tests if the UCB volume serial number is zeros or if the data 
management bit is set. If either condition exists, an SVC 15 instruction is issued to 
execute the user’s channel program. If, however, there is a volume serial number in the 
UCB and the mount bit is not on, module IGE0O125E constructs a channel program to 
read the volume label for the mounted volume and issues an SVC 15 instruction to cause 
the channel program to be executed. When it receives control a second time, after the 
volume label has been read, module IGEO125E matches the volume serial number of the 
mounted volume against the serial number in the UCB for the device. When the serial 
numbers agree, IGE0O125E uses an SVC 15 instruction to cause the originally requested 

LL activity to be performed. If the volume serial numbers do not agree, or if the channel 
program was terminated in error IGE0125E invokes the second module of the Volume 
Verification routine, IGE0225E. The second module issues a demount message for the 
mounted volume and a mount message for the volume whose serial number appears in 
the UCB. 


If an I/O error occurs during reading of the volume label, 10 retries are attempted. If the 
condition cannot be corrected, IGEO125E invokes IGE0225E to issue an error message. 
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APPENDIX D: DYNAMIC DEVICE 
e RECONFIGURATION 


In systems with the dynamic device reconfiguration (DDR) option, a volume mounted 
and in use on one device can be removed and taken to another device where the activity 
on the volume will be resumed. Volumes can be moved at the request of an operator or, 
when there is a permanent I/O error, at the request of the system. Such moves can be 
made without restarting a job to cause device reallocation by job management routines, 
because I/O supervisor DDR routines effectively reallocate by exchanging the 

‘ device-dependent information in the unit control blocks of the two already allocated 
devices. The affected devices may be contained in different logical channels, because 
DDR routines also transfer the request queue elements for any queued requests for the 

“ devices to the correct logical channel queues. 


Refer to OS/VS Recovery Management Logic for detailed information on DDR. 
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APPENDIX E: PROGRAM CHECK RECOVERY 
SUBROUTINE 


The Program Check Recovery Subroutine (PCRS) is assembled within I/O supervisor 
code. PCRS works with the two sections of the Program Check Handler, Prolog and 
ABTERM, to clean up the I/O supervisor control blocks and queues, and to terminate 
tasks. PCRs gains control from the Prolog section of the Program Check Handler when a 
program check error occurs in a task in the I/O supervisor, its appendages, or any 
routine branched to by the I/O supervisor. See Figure 64 for the general flow of control. 


Preparations for processing a program check begin before an error occurs. The I/O 
supervisor, when it first gets control of an RQE, saves the address of the RQE ina 
special save area SVRQE. This allows the PCRS to determine the interrupted task 
without depending on the passing of registers between the routines which gain control at 
a program check. PCRS dequeues the ROE from its logical channel queue by using the 
address at SVRQE, and sets the flags in UCBFL1 to zero, to clear them for the next 
RQE. Finally, PCRS determines the associated TCB for the task, checks it validity, and 
determines the proper ABEND code. Control passes from PCRS to the ABTERM 
section of the Program Check Handler, which schedules the termination. The program 
check error handling ends when ABTERM gives control back to the I/O supervisor 
which places the RQE in the freelist and exits either to the SVC First Level Interruption 
Handler routine, if the program check occurred during an SVC 0, or to the Channel 
Restart routine, if the program check occurred during an SVC 15 or an I/O interruption. 
Now the I/O supervisor readies itself for a new RQE by zeroing out the special save area 
SVROE. 
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Figure 64. Operation of PCRS During a Program Check 





Appendix E: Program Check Recovery Subroutine 111 





Two exceptional conditions may arise: there may be no RQE associated with the 
program check, indicated by the save area SVRQE being zero, and a recurrence may 


occur in PCRS. , 


When there is no valid RQE, PCRS determines whether an SVC 0 was in process, and if 
so, the task pointed to by the current TCB is abnormally terminated with the appropriate 
completion code. If there is no valid RQE and either an SVC 15 or interruption is in 
process, abnormal termination is not attempted. 


In case of recurrence, the Program Check Recovery Subroutine determines if there is a 

valid RQE, and if so, determines if there is a valid TCB. If a valid RQE and TCB can be 

determined the task is abnormally terminated with the appropriate completion code. If 

there is no valid RQE or no valid TCB, processing is handled the same way as when : 
there is no valid RQE. 
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APPENDIX F: SHARED DIRECT-ACCESS 
STORAGE DEVICE 


The shared direct-access storage device (DASD) option allows one direct-access device 
to be shared between two CPUs. The I/O supervisor must, therefore, provide special 
code to allow successful data transfer between the device and each CPU. Since a 
program seeking access to a shared-file device may require either exclusive use of the 
device or shared use of the device, the I/O supervisor uses two special command codes, 
release and reserve. Reserve (X‘B4’) manipulates the switching device to allow exclusive 
use of the device by the CPU; release (X‘94’) manipulates the switching device to allow 
shared use of the device by the CPU. 


A program requiring exclusive use of the shared device must issue a RESERVE macro. 
This causes the reserve count in the UCB to be incremented. Once the reserve command 
is issued, the other CPU has no access to the device until a release command is issued to 
the device. The I/O supervisor issues a release command if the reserve count field is 
zero. This count field is decremented each time the user issues a DEQ macro. 


Regardless of whether or not the user has issued a RESERVE macro, the I/O supervisor 
must also issue a reserve command with every stand-alone seek, regardless of the value in 
the reserve count fields. This prevents the other CPU from moving the access mechanism 
once it has been positioned for the first CPU. If the reserve count is zero, a release is 
issued with the data transfer channel program to free the device for the other CPU. 


If a unit check or a channel error requires a sense operation to be done, a read home 
address and record zero channel program is chained to the sense command; if the reserve 
count in the UCB is zero, the sense command is changed to a release command—a 
special type of sense command. The home address and record zero data, read into the 
UCB’s work area, is required by the device-dependent error recovery procedure. The 
release command frees the device for possible use by the second CPU during the first 
CPU’s error recovery cycle. 


If an active shared device is associated with a purged request, the UCB’s HIO flag is set 
by the purge routine. This causes the I/O supervisor to issue a release to the device, if its 
reserve count is zero. 
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APPENDIX G: I/O SUPERVISOR—OLTEP 
SYNCHRONIZING MODULE (IECIOLTS) 


The Online Test Executive Program (OLTEP) requires the following special support 
from the I/O supervisor: 


e Attention-interruption posting 

e Device-end posting when device-end occurs separately from channel-end 

e Return SIO condition codes when either of above functions is active 

e Exclusive use of a channel by OLTEP 

e Bypassing of the system channel programs for tape devices and direct access devices 
e Specific exposure path selection for multiple exposure devices 


The I/O supervisor maintains the module IECIOLTS which coordinates the I/O 
supervisor functions requested by OLTEP. The address of this routine is contained in the 
I/O supervisor-OLTEP vector table, IECOLTVT. 


To indicate that OLTEP requires assistance from the I/O supervisor, the SVC 59 
instruction sets a series of switches in the IECOLTSW field of IECOLTVT. The I/O 
supervisor exits from four places in its code to check these switches: 


e It exits during the Test Channel routine. 

e It exits during the Halt I/O routine. 

e It exits during the Start I/O routine. 

e It exits during the SIO module for multiple exposure devices. 


If OLTEP indicates a channel function on a 2880 channel, control passes from the Test 
Channel routine in the I/O supervisor to the subroutine in IECIOLTS at label 
OLTCHN. Processing in that subroutine determines whether or not OLTEP has 
exclusive control of a channel. 


The SIO appendage in IECIOLTS at label SIOAPP is entered normally. This appendage 
checks the bypass function bit. If it is on, normal I/O channel programs are bypassed 
and OLTEP operations continue on that channel. 


If OLTEP indicates either device-end or attention posting, control passes from the halt 
I/O routine in the I/O supervisor to the subroutine in IECIOLTS at label OLTHLT. 
This subroutine determines if IOS may issue an HIO on the input device. 


Special OLTEP multiple exposure device code in the I/O supervisor exits to IECIOLTS 
at label OLTEXP to select a specific-exposure access path for OLTEP. 


More information about the routines and appendages in IECIOLTS can be found in 
OS/VS OLTEP Logic. 


The I/O supervisor uses the addressing scheme shown in Figure 65 to gain access to 
IECOLTVT. 
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Figure 65. IECIOLTS Addressing Scheme and Bit Settings 
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APPENDIX H: DEVICE-DEPENDENT ERROR 


ROUTINES 


Device-dependent error routines gain control from the contents supervisor. See 

OS/VS2 Supervisor Logic. Even though each routine has specific characteristics 
tailored for each device type, the basic programming techniques are similar. Each routine 
sets the IOB error indicator bits, examines the sense and CSW status bits that are stored 
in the IOB to determine the type of error, and attempts to recovery from the error, if at 
all possible, by retrying the channel program by means of a direct branch for 
direct-access devices or an SVC 15 instruction for devices other than direct-access. 


The IOB exception flag (IOBEX) and error flag (IOBERR) are turned on by all the 
device-dependent error routines. These settings serve a three-fold purpose: both flags on 
indicate that an error routine is in process; IOBEX on and IOBERR off indicate a 
permanent error; and both flags off indicate a successful retry. The tables included for 
each error routine explain the sense bit settings and describe when retry is or is not 
attempted. 


The sense and CSW bits that are stored in the IOB are checked by the device-dependent 
error routines. By checking the IOBFL1 field of the IOB, chaining types are determined. 
If the IOBFL1 field indicates data and command chaining, no error retry is attempted; if 
it indicates command chaining; error retry is attempted from the address of the CCW 
which caused the error; and if it indicates data chaining or no chaining, the error is 
retried from the first CCW. By checking the CSW status bits in the IOB, the error 
routine determines the type of error that occurred. The bits tested, the priority of the 
testing, and the labels in the error routine to which control goes are shown in the tables 
listed for each device-dependent routine. 


The device-dependent error routines attempt retry of the channel program by issuing an 
SVC 15 instruction. If the retry succeeds, the IOB exception bit and errors flags are reset 
to zero, and normal processing continues. The number of retries attempted depends on 
the device. 


If the CSW status contains a unit check, the device-dependent routine (except for a 
2305, 3330, and 3333) gives control to the statistics update routine to update the 
Statistics table. 


Writing Error Recovery Messages to the Operator 


When an error is uncorrectable or when a condition exists that could be changed by 
operator action, an I/O error routine invokes the I/O supervisor’s Write-to-Operator 
routine, which composes a message to be written on the console output device (Diagram 
12). The Write-to-Operator routine handles three messages: Uncorrectable 
Input/Output Error (IEAQOOI), Inoperative Path (IEA001I), and Intervention Required 
(IEAOOOA). It uses a WTO macro instruction to cause them to be written on the console 
output device. 


The I/O supervisor Write-to-Operator routine is contained in five modules. The first 
(IGE0025C) determines which modules to invoke and produces the ‘intervention 
required’ message. The second (IGE0125C) determines which message is to be written 
and invokes either the third (IGE0225C) or fifth (IGE0425C) load to produce the 
‘uncorrectable input/output error’ message. Load four (IGE0325C) produces ‘start I/O 
condition code 3 error’ messages. The full text of each message isin OS/VS Message 
Library: VS2 System Messages. 
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Individual Routines 


The routine descriptions that follow all have the same organization: a brief description of - 
any characteristics of the routine or device that could be of use in interpreting the 

listings; a table, the Error Analysis Sequence Table, showing the order of examination of 

sense and status bits with pointers to the listings: and a table showing the meanings of 

IOB sense bits, flags, and error count fields for the particular device. 


The tables are to be used as guides in getting to and interpreting the listings, which 
should be considered the final authority. Also: 


e Cross references may sometimes point to approximately where in a listing some action 
is taken. This is because some functions cannot be grouped ‘cleanly.’ As a result, some 
studying may be required to check fully what happens when a particular condition 
arises. 


e The explanations of sense bit meanings are meant to be quick-reference guides. More 
information can be found in the publications mentioned with each routine. 


e The priority of examination of status and sense bits is a design priority. In some cases 
a variation will be found in the implementation. 


The examination of status and sense bits is usually performed by a small utility-type 
routine called the Error Interpreter routine, which is used in common by the error 
routines. It determines which status or sense bits are on, and returns control to 
requesting error routines at the instruction sequences where the errors can be handled. 


Each time the Error Interpreter routine is entered, it checks one bit. An arrangement of 
offset values and addresses in a list within the requesting I/O error routine directs the 
Error Interpreter. The list indicates which bits are to be tested and in what order, and it 
also contains the addresses of the instruction sequences to be used for ‘on’ conditions. 


If a channel error has occurred, the error recovery routine that is entered will have ail” 
available to it an 8-byte area called the error recovery procedure interface block. This is 

produced by the Channel Check Handler routine and includes information that could be 

of use in determining whether or not a restart should be attempted. 


Descriptions of routines in the remainder of this appendix appear in numerical order 
according to the first (or only) device number indicated in the name of the routine. 
(Some routines serve more than one device, but the related routine description is 
included only once.) For example, ‘‘2260 and 1053 Error Routines”’ is included only 
once, among the 22xx routines; it is not also included among the 10xx routines. The 
table that follows indicates which devices (left column) are handled by which routines 
(right column). 

Device Name of Routine 

1052 Printer 1052 Error Routine 

1053 Printer 2260 and 1053 Error Routines 

1275 Optical Reader Sorter 1419 and 1275 Error Routines 

1287 Optical Reader 1287 and 1288 Error Routines , 
1288 Optical Page Reader 1287 and 1288 Error Routines 

1403 Printer 1403 and 1443 Error Routines 


1419 Magnetic Character 1419 and 1275 Error 
Reader Routines 


1443 Printer 1403 and 1443 Error Routines 

2250 Display Unit 2250 Error Routine 

2260 Display Station 2260 and 1053 Error Routines J 
2305 Fixed Head Storage 2305, 2314, 2319, 3330, and 3333 


Error Routines 


118 OS/VS2 I/O Supervisor Logic 


S 


2314 Direct-Access Storage 
Facility 


2319 Direct-Access Storage 
Facility 


2400 Series Magnetic Tape 
Units 


2495 Tape Cartridge Reader 
2501 Card Reader 

2520 Card Read Punch 
2540 Card Read Punch 

3211 Printer 

3330 Disk Storage 


3333 Disk Storage and Control 


3410 Magnetic Tape 


3420 Magnetic Tape 


3505 Card Reader 


3525 Card Punch with Read 
and Punch Features 


1052 Error Routine 


2305, 2314, 2319, 3330, and 3333 
Error Routines 


2305, 2314, 2319, 3330, and 3333 
Error Routines 


2400 and 3400 Tape Series 
Error Routines 


2495 Error Routine 
2501 and 2520 Error Routines 
2501 and 2520 Error Routines 
2540 Error Routine 
3211 Error Routine 


2305, 2314, 2319, 3330, and 3333 
Error Routines 


2305, 2314, 2319, 3330, and 3333 
Error Routines 


2400 and 3400 Tape Series 
Error Routines 


2400 and 3400 Tape Series 
Error Routines 


3505 and 3525 Error Routines 
3505 and 3525 Error Routines 


Special considerations are necessary for errors on the IBM 1052 Printer-Keyboard. 
Messages can be issued through the Write-to-Operator routine only for read errors. The 
operator is notified of other types of errors by use of the console alarm bell. 


The 1052 error routine attempts recovery from channel data checks. The 1052 error 
routine also examines the error recovery procedure interface block to determine whether 
it should attempt recovery from channel control checks and interface control checks. 


The 1052 error routine uses bits MO and M1 in the third byte of the IOB flags field to 
control its procedure on subsequent entries after an error. If both bits are set to 0, the 
Error Interpreter routine is used to determine the type of error. If MO has been set to l, a 
permanent error has occurred and control has been received from the Error EXCP 
routine to ring the console alarm. If M1 has been set to 1, ‘intervention required’ has 
been signaled, and the original channel program is to be retried. 


The error analysis sequence for the 1052 is shown in Figure 66. The meanings of the 
sense bits, IOB flags, and IOB error counts are shown in Figure 67. More information 
can be obtained from JBM System/360 Component Descriptions and Operating 
Procedures: IBM 1052 Printer-Keyboard Model 7 with IBM 2150 Console, 


GA22-6877. 


Sense Byte 0 Meanings and Actions Taken 


Bit 0: Command Reject 


This bit is set when an invalid command code is detected. The IOB error flag is turned 
off and the IOB exception flag is turned on indicating a permanent error. Control is 
returned to the I/O supervisor via an SVC 15 instruction for abnormal termination. 


Bit 1: Intervention Required 


This bit is set when the printer runs out of forms or when the not-ready key has been 
depressed. The error routine places the control command to ring the console alarm in 
the reposition modifier field of the IOB. The modifier flag 1 is set in the IOB to signal 
the Unit Record SIO routine to build a CCW employing this command code. Bit M1 is 
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Status Sense Applicable to: 

Priority Bit Byte Bit Condition Read Write Pointer 
1 45 Channel Control Check xX xX ERRS530 J 
l 46 Interface Control Check xX X ERRS530 
2 47 Chaining Check Xx X ERR524A 
3 38 Unit Check x x ERRSOI 
4 0 7 Should Not Occur xX xX ERRS504 
5 0 6 Should Not Occur x xX ERRSO4 
6 0 5 Should Not Occur x xX ERRS04 
7 0 4 Should Not Occur x xX ERRS504 : 
8 0 3 Equipment Check xX xX ERRS06 
9 0 I Intervention Required xX x ERRS509 > 
10 0 2 Bus-Out Check xX Xx ERRS10 
11 0 0 Command Reject xX X ERRSI8A 
12 44 Channel Data Check xX xX ERRS525 
13 42 Program Check xX Xx ERRSI8A 
14 43 Protection Check xX xX ERRSI8A 
15 39 Unit Exception Xx ERRS18B 
16 41 Incorrect Length Xx xX ERRSI8A 


Figure 66. 1052 Error Analysis Sequence (Module IGEOQOOOD) 





set in the IOB and control returned by SVC 15. The intervention-required condition 
does not terminate a read or write operation that is already in progress. 
) 


Bit 2: Bus-Out Check 
This bit is set when a parity error is detected on a command or data byte. The error 
routine sets the bus-out flag in the IOB and retries the user’s channel program via 
SVC 15. If the error recurs, the control command to ring the console alarm is placed 
in the reposition modifier field of the IOB, and modifier flag 1 is set to signal the Unit 
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Figure 67. 1052 Sense Bits, IOB Flags and, IOB Error Counts 
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Record SIO routine to construct a CCW with this command. IOB bit MO is set and 
control returned via SVC 15. Five retries are attempted on console devices of systems 
with multiple console support. 


Bit 3: Equipment Check 
This bit is set when one of the following occurs: 


e Keyboard parity error. 
e Keyboard-printer compare check. 
e Printer failed to take a mechanical cycle during a read or write operation. 


If the error occurred on a read command, a permanent error is assumed and the 
Write-to-Operator routine is invoked; it writes a message (IEAOOOI) indicating failure 
to read input messages. For write errors, the error routine retries the channel program 
via SVC 15. On the second occurrence of the error, the console bell is rung via the 
procedure described above for bus-out check. Five retries are attempted on console 
devices of systems with multiple console support. 


Bits 4-7: Should Not Occur 
If any of these bits is set, a catastrophic error is assumed. A permanent error is 
signaled to the Unit Record SIO routine and control is returned via SVC 15. Five 
retries are first attempted on console devices of systems with multiple console support. 


1287 and 1288 Error Routines 


The IBM 1287 Optical Reader error routine (module IGE0011C), 1287 Error routine 
(module IGE0011C) and the IBM 1288 error routine (module IGEO011D) attempt 
recovery from channel data checks. They also examine the error recovery procedure 
interface block to determine whether they should attempt recovery from channel control 
checks and interface control checks. 


The error analysis sequence for the 1287 and 1288 is shown in Figure 68. The meanings 
of sense bits, IOB flags, and IOB error counts for the devices are shown in Figure 69. 
More information can be obtained from the following publications: 


e IBM 1287 Optical Reader Component Description and Operating Procedures, 
GA21-9064 


e IBM 1288 Optical Page Reader Model 1 Component Description, GA21-9081 
Sense Byte Meanings 


Byte 0, Bit 0: Command Reject 
This bit is set when the command is incorrect for the operating mode, such as a Mark 
Line command in document mode or a normal command in CE diagnostic mode. An 
invalid command sequence, such as two consecutive ejects, will also cause the bit to be 
set. 


Byte 0, Bit 1: Intervention Required 
This bit is set when the device is not in ready status. 


Byte O, Bit 2: Bus-Out Check 
This bit indicates that invalid parity has occurred in a command or data. 


Byte 0, Bit 3: Equipment Check 
One of the following has occurred: (1) the device was unable to completely 
read a line or field, (2) the 1287 or 1288 could not locate the reference mark, or (3) 
the 1288 failed to find a timing mark. 


Byte 0, Bit 4: Data Check 
The optical reader has sent at least one reject character or substitute character. 
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Status Sense 
Priority Bit Byte Bit Condition Pointer 

1 45 Channel Control Check ERROO41 
2 46 Interface Control Check ERRO041 
3 44 Channel Data Check ERROO41 
4 32 Control Unit End ERRO041 
5 38 Unit Check ERROO041 
6 1 3 Should Not Occur ERRO06 

6 l 5 Should Not Occur ERRO006 

6 1 6 Should Not Occur ERRO06 

6 l 7 Should Not Occur ERRO06 

‘| 1 0 Tape Mode (1287 only) ERRO06 

8 0 7 Should Not Occur ERRO06 

9 0 3 Equipment Check ERROO6C 
10 0 6 Non-Recovery ERROO6C 
11 0 l Intervention Required ERRO06C 
12 0 2 Bus-Out Check ERRO06C 
13 0 4 Data Check ERROO6C 
14 0 5 Overrun ERRO06C 
15 0 0 Command Reject ERROO6C 
16 1 4 Invalid Operation ERROO6C 
17 47 Chaining Check ERROO4B 1 
18 42 Program Check ERROO4B 1 
19 43 Protection Check ERROO4B 1 
20 41 Incorrect Length ERROO4B 1 


Figure 68. 1287 and 1288 Error Analysis Sequence 





Byte O, Bit 5: Overrun 
An overrun condition occurs when the channel fails to service the optical reader in 
time and at least one character is lost. 


Byte 0, Bit 6: Non-recovery 
The operator must reload and restart the optical reader because (1) the document or 
tape is jammed, (2) the runout key was depressed while a document or tape was being 
processed, or (3) the scanner door was open when the device was not in the line 
display mode. 


Byte 0, Bit 7: Keyboard Correction 
The 1287 has displayed at least one unreadable character for online correction. 


Byte 1, Bit 0: Tape Mode 
The 1287 Model 2 is operating in the tape mode. 


Byte 1, Bit 1: End of Page (1288) 
The bottom of the page has been detected while reading in the unformatted document 
mode. 


Byte 1, Bit 1: Late Stacker Select (1287) 
The Stacker Select command did not arrive in time and the document was placed into 
the reject stacker. 
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Keyboard 
Intervention Bus-Out Equipment Data Overrun Non- Correction 
Required Check Check Check Recovery (1285, 1287 
Tape Mode 
Only) 


Tape Mode No 
Sense Byte | (1287 Only) Document Invalid 
(1287, 1288 Only) Found Operation 


00 No Chaining Error 
01 Command Chaining Routine Exceptional 0 Stort 
{OBFLI 10 Data Chaining in Condition 1] Restart 
11 Command and 
Data Chaining conve! 
IOBFL3 Message 
Type 


IOBINCAM Data Check Count 
(Byte 1) 


|OBINCAM Incorrect Length Count 
(Byte 2) 


10B 


Error Counts Equipment Check Count 
Byte ] 


1OB 
Error Counts Overrun Error Count Chaining Check Count 
Byte 2 





Figure 69. 1287 and 1288 Sense Bits, IOB Flags, and IOB Error Counts 





Byte 1, Bit 2: No Document Found 
A document did not enter the reading station after the last eject command and there 


was no jam. 
Byte 1, Bit 3: Not Used 


Byte 1, Bit 4: Invalid Operation 
Invalid information was specified in the load format instruction. For example: bit 2, 3, 
4, or 5 of the fourth byte represents bits not used; fewer than four bytes were 
transmitted; or an uninstalled font was specified in the CCW. 


Byte 1, Bits 5-7: Not Used 
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1403 and 1443 Error Routines 


The IBM 1403 Printer and IBM 1443 Printer error routine attempts recovery from the J 
special condition where channel data checks occur with bus-out checks. The 1403 and 

1443 error routine also examines the error recovery procedure interface block to 

determine whether it should attempt recovery from channel control checks and interface 

control checks. 


The error analysis sequence for the 1403 and 1443 is shown in Figure 70. The meanings 
of sense bits, IOB flags, and IOB error counts are shown in Figure 71. More information 
can be obtained from the following publications: 


« IBM 1403 Printer Component Description, GA24-3073 + 


e IBM 1443 Printer Models 1 to 4 and NI; IBM 1445 Printer Models 1 and 
NI, GA24-3120 








s 
Status Sense 
Priority Bit Byte Bit Condition Pointer 
1 45 Channel Control Check ERROS1 
| 46 Interface Control Check ERROS1 
2 47 Chaining Check ERRO71 
3 38 Unit Check ERROS3 
4 0 6 Should Not Occur ERROS2F 
5 0 3 Equipment Check ERROS2F 
6 0 | Intervention Required ERROS4 
7 0 2 Bus-Out Check ERROS56 
8 0 7 Channel 9 ERROS9 
9 0 0 Command Reject ERROS2E Jd 
10 44 Channel Data Check ERRO067 
11 42 Program Check ERRO63 
12 43 Protection Check ERRO63 
13 39 Unit Exception ERR064 
14 41 Incorrect Length ERR068 
The sequence shown above is for the 1403 without the Universal Character Set (UCS) feature, and for 
the 1443. 
For 1403s with UCS, bits 4 and 5 of sense byte 0 mean ‘data check’ and ‘parity check,’ respectively. 
Their priority falls between 9 and 10 and 5 and 6, respectively. 
9.1 0 4 Data Check ERROS2E 
5.1 0 5 Parity Check ERROS2D 
Figure 70. 1403 and 1443 Error Analysis Sequence (Module IGEOOO0G) : 
Sense Byte 0 Meanings and Actions Taken , 
Bit 0: Command Reject 
This bit is set when one of the following occurs: 
e A Read Backward command is received. 
e A carriage instruction to space more than three lines is received. 
e A Carriage instruction to skip to channel 0, 13, 14, or 15 of the carriage control 
tape is received. > 
e Any command is received which the device is not designed to execute. 
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Command Intervention Equipment Channel 9 


Sense Byte 0 
Reject Required Check 


Typebar Typebar 
Selection Selection 


00 No Chaining E 
01 Command Chainin ae . 
g Routine Exceptional 0 Start 


ot 1 fees — a 


ntrol 
Data Chaining Rentre 


Bus-Out 
UCS Parity or Channel 
t M 
lOBFL3 a ry Error Data Check T oe 
it ype 
Count Error 
Count 
Error Counts Multiple Multiple Multiple Multiple 
IOBECT Console Console Console Console 
Support Retry Support Retry Support Retry | Support Retry 


Channel Control 
JOBECT Check, Interface 
Control Check 


Error Counts 





Figure 71. 1403 and 1443 Sense Bits, IOB Flags, and IOB Error Counts 


The error is considered permanent. 


Bit 1: Intervention Required 
This bit indicates a not-ready condition due to one of the following: 


e The printer has run out of forms or the forms have jammed. 

e The Stop Key has been depressed. 

e The cover interlock switch is open. 

e The typebar motor switch is set to the OFF or REMOVE position. 


When this bit and bit 7 (Channel 9) are on, the error is handled as a Channel 9 
condition. In all cases, an Intervention Required message is issued to the operator who 
must correct the condition. When the intervention required condition alone is 
corrected, the last operation is repeated. 


Bit 2: Bus-Out Check 
This bit indicates that a parity error has occurred on a bus-out command or data byte. 
If this bit is set during the initial selection of a control unit or a device, the operation is 
retried. If it is set during channel end, the error is automatically considered permanent 
unless it occurs on the console device of a system having the Multiple Console 
Support feature, where it is retried five times. 


Bit 3: Equipment Check 
This bit indicates that a program-correctable malfunction was detected in the printer 
or in its controls. The malfunctions are buffer or hammer checks on the 1403 and 
typebar-synchronization errors on the 1443. These errors are reset by the next Write 
or Control command. Five retries are attempted on systems with multiple console 
support before the error is considered permanent, if the printer is being used as a 
console. Otherwise, the error is considered to be permanent, and no retry is 
attempted. 


Bit 4: Data Check (1403 Only) 
If the 1403 has the Universal Character Set (UCS) feature, this bit is set when a code 
in a data record sent to the printer does not match a code in the UCS feature storage. 
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(Without UCS, this bit should not be set.) The error is automatically considered 
permanent unless it occurs on the console device of a system having the Multiple 
Console Support feature, where it is retried five times. j 


Bit 5: Parity Error (1403 Only) 
If the 1403 has the Universal Character Set (UCS) feature, this bit indicates a parity 
error was detected in data being written into or read from UCS feature storage. If the 
error occurs while the UCS storage is being loaded, one retry is attempted. If it occurs 
at any other time, the error is considered permanent. In systems having the Multiple 
Console Support feature, five retries are attempted for console devices. 


Bits 4 and 5: Typebar Selection (1443 Only) 


The combination of these two bits indicates the position of the typebar selector 4 
switch. 

Bit 4 Bit 5 Switch Setting 

> 

0 0 52-character set 

0 1 13-character set 

1 0 39-character set 

| 1 63-character set 


These bits can be changed only by repositioning the typebar selector switch. They are 
considered normal, and the error routine continues the channel program. 


Bit 6: Should Not Occur 
If this bit is set, a catastrophic error is assumed. The logout flag is set in the IOB, a 


permanent error is signaled to the Error EXCP routine, and control is returned via 
SVC 15. 


Bit 7: Channel 9 
This bit is set when a hole is sensed in channel 9 of the carriage control tape. 


1419 and 1275 Error Routines J 


The IBM 1419 Magnetic Character Reader and IBM 1275 Optical Reader Sorter error 
routine attempts recovery from channel data checks. The 1419/1275 error routine also 
examines the error recovery procedure inteiface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 


The error analysis sequence is shown in Figure 72. The meanings of sense bits, IOB flags, 
and IOB error counts are shown in Figure 73. Sense byte 2 is applicable only to the 
secondary control unit of systems with the Dual Address Adapter feature. 


More information can be obtained from the following publications: 
e IBM 1219 Reader Sorter, IBM 1419 Magnetic Character Reader, GA24-1499 


e IBM 1419 Magnetic Character Reader and IBM 1275 Optical Reader Sorter, 
Device-Dependent BSAM Program Logic Manual, GY21-0012 


Sense Byte Meanings 


Byte 0, Bit 0: Command Reject 
This bit is set when an invalid command is received. Invalid commands include: 


e Two Read commands without an intervening Stacker Select command when the 
1419 is in program-sort mode 


e A Stacker Select command given for an auto-selected document 
e A second Stacker Select command after one has been accepted for a document 


e A Write command given when the machine is not in diagnostic mode ) 
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Status Sense 
Priority Bit Byte Bit Condition Pointer 
| 45 Channel Control Check ERRO20 
2 46 Interface Control Check ERRO20 
3 44 Channel Data Check ERRO20 
4 38 Unit Check ERRO20 
=) 0 3 Should Not Occur ERROS1 
6 0 7 Document Spacing Error ERROS1 
7 0 1 Intervention Required ERROS1 
8 0 2 Bus-Out Check ERROS51 
9 0 4 Data Check ERROS1 
10 0 5 Overrun ERROS1 
1] 0 6 Auto Select ERROS51 
12 0 0 Command Reject ERROS51 
13 47 Chaining Check ERRO69 
14 42 Program Check ERRO69 
15 43 Protection Check ERRO69 
16 41 Incorrect Length ERRO69 


For the secondary control unit, the following sense bytes are examined in place 
of those shown above: 


5 pi 2 Bus-Out Check ERRO6I1 
6 Ps 4 Should Not Occur ERRO61 
7 2 3 Should Not Occur ERRO61 
8 Zz l Intervention Required ERRO61 
9 Z 7 Operator Attention ERRO6I 
10 2 0 Command Reject ERRO61 
11 2 5 Late Stacker Select ERRO61 
12 2 6 Auto Select ERRO61 


Figure 72. 1419/1275 Error Analysis Sequence (Module IGE0011E) 





Byte 0, Bit 1: Intervention Required 


This bit indicates that operator attention is needed for one or more of the following 
reasons: 


Document jam 

Full stacker 
Sort-check 

Endorser stop 
End-of-transport stop 
Film stop 


Batch number advance check stop 


Motor not running 


Byte 0, Bit 2: Bus-Out Check 


This bit is set for parity errors on information coming from the CPU via the interface. 


Byte 0, Bit 3: Should Not Occur 
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Sense Byte 0 Command Intervention Overrun 
Reject Required 
Document Process Account Transit Serial 
Sense Byte | Under Control Number Field Number 
Read Head Field Valid Field Valid Valid Field Valid 
a 








Sense Byte 2 Command Intervention Bus-Out Late Auto- Operator 
(Secondary Reject Required Check Stacker Select Attention 


Control Unit Only) Pr 


00 No Chaining Error 

01 Command Chaining Routine Exceptional 
lOBFLI 10 Data Chaining in Candition 

1) Command and Control 

Data Chaining 
- | 
IOBFL3 Permanent 
Error 


Figure 73. 1419/1275 Sense Bits, IOB Flags, and IOB Error Counts 





Sense 


Bit 








Byte 0, Bit 4: Data Check 
This bit indicates that one or more of the selected fields in the document was not read 
correctly. 


Byte 0, Bit 5: Overrun 
This bit is set when a character is not accepted. The field containing the error is identified 
by a OQ in bits 3 to 7 of sense byte 1. 


Byte 0, Bit 6: Auto-Select 
This bit is set when a document is automatically selected into the reject pocket. A 
51-column card turns the indicator on if the 51-column feature is not installed. If a 
Stacker Select command is issued for an auto-selected document, the command reject 
bit will be set. 


Byte 0, Bit 7: Should Not Occur 
Byte 1, Bit 0: Should Not Occur 
Byte 1, Bit 1: Should Not Occur 


Byte 1, Bit 2: Document Under Read Head 
This bit is normally used in diagnostic mode only. 


Byte 1, Bit 3: Amount Field Valid —When this field is selected at the operator panel, 
and is read without error (including symbols), the bit is set to one. 


Byte 1, Bit 4: Process Control Field Valid —When this field is selected at the operator J | 
panel, and is read without error (including symbols), the bit is set to one. 
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Byte 1, Bit 5: Account Number Field Valid —When this field is selected at the operator 
panel, and is read without error (including symbols), the bit is set to one. 


Byte 1, Bit 6: Transit Field Valid —When this field is selected at the operator panel, and 
is read without error (including symbols), the bit is set to one. 


Byte 1, Bit 7: Serial Number Field Valid —When this field is selected at the operator 
panel, and is read without error (including symbols), the bit is set to one. 


Byte 2 (Secondary Control Unit Only): 


Byte 2, Bit 0: Command Reject 
This bit is set when an invalid command is received by the secondary control unit 
(SCU). The following commands are considered invalid in the SCU: 


e Read 
e Read Backwards 
e Write 


Byte 2, Bit 1: Intervention Required 
See byte 0, bit 1. 


Byte 2, Bit 2: Bus-Out Check 
This bit is set for parity errors on information coming from the CPU via the interface. 


Byte 2, Bit 3: Should Not Occur 
Byte 2, Bit 4: Should Not Occur 


Byte 2, Bit 5: Late Stacker Select. 
This bit is set when a Stacker Select command is given for a document which has 
passed the select station. The document is rejected. 


Byte 2, Bit 6: Auto-Select 
This bit is set when a Stacker Select command is issued for a document that is 
auto-selected. 


Byte 2, Bit 7: Operator Attention 
This bit is set when the Update switch is off and a Stacker Select command is issued to 
effect batch-numbering update. 


2501 and 2520 Error Routines 


The IBM 2501 Card Reader and 2520 Card Read Punch error routine attempts recovery 
from channel data checks on 2501 -and 2520 read errors. Each read operation is retried 
once. 


The error analysis sequence is shown in Figure 74. The meanings of the sense bits, IOB 
flags, and IOB error counts are shown in Figure 75. More information about the 
individual devices can be obtained from the following publications: 


e IBM 2501 Models BI and B2 Component Description and Operating Procedures, 
GA21-9026 


e IBM 2520-B1, B2, and B3 Component Description and Operating Procedures, 
GA21-9027 
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Status Sense 
Priority Bit Byte Bit Condition Pointer 
I 45 Channel Control Check ERROO2 
I 46 Interface Control Check ERROO2 
2 38 Unit Check ERROO2 
3 0 6 Should Not Occur ERROO4 
4 0 3 Equipment Check ERROO8 
5 0 7 Should Not Occur ERRO04 
6 0 1 Intervention Required ERRO36 
7 0 Z Bus-Out Check ERROI3 
8 0 4 Data Check ERROI7 
9 0 5 Overrun ERRO20 
10 0 0 Command Reject ERROO6 
1] 44 Channel Data Check ERRO35 
12 47 Chaining Check ERRO29 
13 42 Program Check ERRO29 
14 43 Protection Check ERRO29 
15 39 Unit Exception ERRO29 
16 4] Incorrect Length ERRO29 


Figure 74. 2501 and 2520 Error Analysis Sequence (Module IGEQOOOE) 





Sense Byte 0 Meanings and Actions Taken 


Bit 0: Command Reject 


This bit is set when a Read Backward command is issued, or when any other 
command is received which the device has not been designed to execute. The error is 


considered permanent. 


Bit 1: Intervention Required 
This bit is set when one of the following occurs: 


e The power is off. 


e Cards are not registered at the read station. 


e The stacker is full. 


e The feed check light is on. 


e The stop key has been depressed. 


e The chip box is full, or has been removed. 


e There are no cards in the hopper and the End-of-File light is not on. 


e The cover interlock switch is open. 


A message is given to the operator, who must take action. Upon correction of the 
condition, the interrupted operation is repeated. 


Bit 2: Bus-Out Check 
This bit is set when a parity error has occurred on bus-out during transfer of command 
or data bytes, but not during the time period of address-out or command-out proceed. 
For a command byte one retry is attempted. If the error is not corrected it is 
considered permanent. For a data byte, the card is already punched and the error is 
considered permanent. However, on a 2501, the error is automatically retried once. 
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Sense Byte Q 
JOBFLI 
JOBFL3 


ee ee ee ee eee 







2 No Chaining 
01 Command Chaining 
10 Data Chaining 
11 Command ond 
Data Chaining 













Intervention 






Equipment 


Required Check 


Data Overrun 
Check 








Error 
Routine 
in 

Control 


Q Start 
1 Restart 


Exceptional 










Condition 






Figure 75. 2501 and 2520 Sense Bits, IOB Flags, and IOB Error Counts 


2250 Error Routine 


The IBM 2250 Display Unit error routine attempts recovery from channel data checks. 
The 2250 error routine also examines the error recovery procedure interface block to 
determine whether it should attempt recovery from channel control checks and interface 
control checks. 


Bit 3: Equipment Check 


Message Overrun 
Type Count 
This bit is set when one of the following occurs: 


e An invalid card code is detected during a punch operation. 
e During a read or punch operation an error is detected during the 9-bit match. 
The invalid card code part of equipment check is not set during card image punch. 


If the error occurs during a punch operation other than QSAM, it is automatically 
considered permanent. With QSAM an error occurring during a punch operation is 
retried. If it occurs during a read operation, one retry is attempted. 


Bit 4: Data Check 


This bit is set when an invalid card code is detected during a read operation. This error 
pertains to the last card for which data was sent. A message is typed and an operator 
must reposition the cards for one retry. If the error persists, it is considered 
permanent. 


Bit 5: Overrun 


This bit is set if during a read operation the interface has not transmitted a character 
by the time the next character is to be read into the register. The operator must 
reposition the cards. The operation is retried once and if the error persists it is 
considered permanent, and a message is written to the console. 


Bits 6 and 7: Should Not Occur 


If either of these bits is set, a catastrophic error is assumed. A permanent error is 
signaled to the Error EXCP routine and control is returned via SVC 15. 


The error analysis sequence for the 2250 is shown in Figure 76. The meanings of sense 
bits, IOB flags, and IOB error counts are shown in Figure 77. More information can be 
obtained from the following publications: 


e IBM System/360 Component Description: IBM 2250 Display Unit Model 1, 


GA27-2701 
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e IBM System/360 Component Description: IBM 2250 Display Unit Model 2; 
IBM 2840 Display Control Model 1, GA27-2702 





Sense Byte 0 Meanings and Actions Taken 


Bit 0: Command Reject 
This bit is set when there is an invalid modifier bit in a command or an invalid invalid 
command sequence. The error is considered permanent. 


Bit 1: Should Not Occur 
When this bit is set, a catastrophic error is assumed. The logout flag in the IOB is set 
and the permanent error procedure is performed. 


Bit 2: Bus-Out Check 
This bit is set when a parity error is detected on a command or data byte during 
bus-out. The operation is retried once. If the retry is unsuccessful, a message is written 
to the operator. 


Bit 3: Equipment Check (Model 2); Should Not Occur on Others (See Bit 1). 


Bit 4: Data Check 
This bit is set when a buffer parity error is detected either during a read operation or 
during image regeneration. The operation is retried once. If the retry is unsuccessful, a 
message is written to the operator. 


Bit 5: Should Not Occur (See Bit 1) 


Bit 6: Buffer Running 
This bit indicates that regeneration is in process. When accompanied by Command 
Reject, a permanent error is assumed. 


Bit 7: Should Not Occur (See Bit 1) 





Status Sense Applicable to 
Priority Bit Byte Bit Condition 2250-1 2250-2 Pointer 
1 45 Channel Control Check xX xX ASRON 
2 46 Interface Control Check xX xX ASRON 
3 44 Channel Data Check X X TESTST 
4 38 Unit Check X X MAINER 
5 0 l Should Not Occur X SEROUT 
5 0 3 Should Not Occur xX X SEROUT 
2) 0 5 Should Not Occur xX xX SEROUT 
5 0 7 Should Not Occur x x SEROUT 
6 0 2 Bus-Out Check xX xX BOICHK ° 
vi 0 4 Data Check Xx Xx DATACX 
8 0 0 Command Reject x XxX PERMER ; 
0 0 Command Reject Note I PERMER 
9 0 6 Buffer Running X xX 
10 42 Program Check xX X PERMER 
11 43 Protection Check xX xX PERMER 
12 41 Incorrect Length XxX xX PERMER 


Note: For an unbuffered 2250 Model | the following changes are necessary: 
a. Command Reject with Buffer Running is a ‘Should Not Occur’ condition with Priority 5, Pointer SEROUT. ) 


b. Priorities 10, 11, and 12 become 9, 10, and 11, respectively. 


Figure 76. 2250 Error Analysis Sequence (Module IGEOQ010A) 
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Equipment 
Command ee 


(Model 2) 


Sense Byte | Pen Order 
Defect Sequence 


00 No Chaining Error 
0) Command Chaining Routine Exceptional 
é |\OBFLI 10 Data Chaining in Condition 1 Restart 


1] Command and Data Control 
Chaining 


JOBFL2 Halt I/O Film 
Issued Unit 
{OBFL3 


|OB Bus-Out | Bus-Out 2 Equipment End Channel 


Abnormal 


Error Counts Retry Retry 
Byte | Indicator Indicator 


Appendage Data 


Interface 

Control 
1OB Check or 
Error Counts Channel 
Byte 2 Control 

Check 





Figure 77. 2250 Sense Bits, IOB Flags, and IOB Error Counts 





2260 and 1053 Error Routines 


The IBM 2260 Display Station and IBM 1053 Printer error routine attempts recovery 
from channel data checks. The 2260 and 1053 error routine also examines the error 
recovery procedure interface block to determine whether it should attempt recovery from 
channel control checks and interface control checks. 


The error analysis sequence for the 2260 and 1053 is shown in Figure 78. The meanings 
of sense bits, IOB flags, and IOB error counts are shown in Figure 79. More information 
can be obtained from the publication JBM System/360 Component Description: IBM 

2260 Display Station; IBM 2848 Display Control, GA27-2700. 
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Status Sense Applicable to 
Priority Bit Byte Bit Condition 2260 1053 Pointer Load! 
1 45 Channel Control Check x X ASRON J 
2 46 Interface Control Check xX xX ASRON | 
3 44 Channel Data Check xX xX TESTST I 
4 38 Unit Check x xX MAINER | 
5 0 4 Should Not Occur xX xX SEROUT I 
5 0 D Should Not Occur xX x SEROUT l 
5 0 6 Should Not Occur xX xX SEROUT I . 
6 0 3 Equipment Check xX EC I 
z} 0 1 Intervention Required X 2260-SEROUT I 
8 0 2 Bus-Out Check Xx Xx BOI . 
Initial Selection 
8 0 Z Bus-Out Check x ISBUSOUT | 
Data Transfer 
8 0 Z Bus-Out Check x ISBUSOUT I 
Data Transfer 
9 0 0 Command Reject x D4 PERMER 1 
10 42 Program Check XxX xX PERMER I 
11 43 Protection Check x xX PERMER I 
12 41 Incorrect Length XxX xX PERMER l 


1Only first-time equipment check errors are handled by load 2. 


Figure 78. 2260 and 1053 Error Analysis Sequence (Load 1—IGE0010B or Load 2—IGE0100B) 


Sense Byte Meanings and Actions Taken 


Bit 0: Command Reject. This bit is set when there is an invalid modifier bit in a 
command, or an invalid command sequence. The error is considered permanent. 


Bit 1: Intervention Required 


This bit is set when a 1053 Write command is given but the 1053 is not ready. A 
message is written to the operator. 


Bit 2: Bus-Out Check 


This bit is set when a parity error is detected on a command or data byte during 
bus-out. Processing depends upon when the bus-out check occurred and what 
command was last executed: 


If the bus-out check occurred during initial selection, or during data transmission for 
the 2260 after a Write Line Address or an Erase command, one retry is attempted. If 
the retry is unsuccessful a message is written to the operator. 


If the bus-out check occurred during data transmission for the 2260 after a Write 

Buffer Storage command, one retry is attempted, but before that retry an Erase Buffer ? 
Storage command is issued. If the retry is unsuccessful, a message is written to the 

operator. 


Bit 3: Equipment Check 


This bit is set when a parity error is detected during a manual read input operation. 

The second load of the 2260 and 1053 error routine erases the message in error and 

displays an error message on the screen. No automatic retry occurs. If a retry is 

desired, the necessary coding must be included in the user’s program. (If the error 

occurs a second time, the user’s program should consider it permanent.) J 
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Sense Byte 0 Command Intervention 
Reject Required 
00 No Chaining Error 
Q1 Command Chaining Routine Exceptional 
JOBFLI 10 Data Chaining in Condition 1 Restart 
1] Command and Control 
Data Chaining 
IOBFL2 


IOBFL3 Message 
Type 


Bus-Out Bus-Out Abnormal 
Error Counts Céant | Counts Routine End 


Byte | Channel Appendage 
Program Bit 


Interface 
1OB Control 
Error Counts Check or 
Byte 2 Channel 

Control 


Check 





Figure 79. 2260 and 1053 Sense Bits, IOB Flags, and IOB Error Counts 


Bits 4-7: Should Not Occur 
If one of these bits is set, a catastrophic error condition is assumed. The logout bit in 
the IOB is set, and a permanent error procedure is performed. 


| 2305, 2314, 2319, 3330, and 3333 Error Routines 


This routine is resident and is generated by a macro during system generation to service 
the types of devices at an installation. 


This routine attempts recovery from channel data checks. It also examines the error 
recovery procedure interface block to determine whether it should attempt recovery from 
channel control checks and interface control checks. 


Channel programs are usually restarted from the beginning to avoid a repositioning 
problem, command and data chaining problems, and to simplify the handling of errors 
within errors. 


When a ‘track condition check’ error occurs, the home address record and record 0 are 
read to determine whether the track is defective or is an alternate track. A bit in the 
UCB is checked to determine whether the home address and record 0 have already been 
read by DSS; if not, ERP does the read. If the track is defective, the address of the 
alternate track is used in a Seek command, and the the operation is resumed on the 
alternate track. If the track condition check occurred on an alternate track, the defective 
track’s address, plus 1, is used in a Seek command and the operation is resumed on the 
new track. 
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When a ‘no-record-found’ error occurs, a console message is not issued if the access arm 
has been positioned at the correct track. A ‘permanent error’ indicator is set in the 
input/output block. 





When the overflow incomplete bit (sense byte 1, bit 7) is set, only a partial record has 
been read or written, and a CCW is constructed so the remainder of the record can be 
processed. When the ‘overflow incomplete’ bit is set and the ‘file mask violation’, 
‘end-of-cylinder’, or ‘track condition check’ bit is also set, the error routine assumes that 
the first record of the continuation track is properly identified as record number 1. 


This error routine handles cylinder and head switching for both sequential and split 
cylinders. 


A bit in the CVT is checked prior to the ERP attempting to cause any transients to be 
loaded. This bit is turned on by NIP at IPL time and turned off when NIP has proceeded 
far enough to allow transients to be loaded. Y 


When a permanent I/O error is detected for the Paging Supervisor, a Deferred Incident 
Record is built by the ERP for subsequent recording into SYS1.LOGREC. This record 
contains, essentially, the same information as the non-Paging Supervisor permanent I/O 
SYS1.LOGREC record. See OS/VS SYSI.LOGREC Error Recording Logic for more 
information about error recording. 


[ When a 2305, 3330, or 3333 presents a unit check, IOS performs a sense I/O command 
for 24 bytes and then enters the resident direct access ERPs. The ERP then checks the 
error indications in the CSW and sense bits according to the following precedence table 
(Figure 81) until a bit is found on. The action referred to will then be performed. 


| The control units for a 2305, 3330, and 3333 have an error correction capability known 
as the Error Correction Function, or ECF. If a data check occurs in a count or key area, 
the control unit performs ECF internally. If a data check occurs in the data field, the 7 
sense bytes contain a displacement and a 3-byte correction code for the ERP to use in -) 
correcting the error. The ECF supplied by a 3330, 3333, and 2305 corrects up to three 

contiguous bytes of data. 


| A 3330 or 3333 control unit presents the displacement to the error starting from the 
beginning of the data field, which allows the ERP to apply the correction code when data 
chaining is being performed in the data field. Because a 2305 control unit presents the 
displacement from the last byte transferred, the ERP only corrects the last segment if 
data chaining in the data field is used. If the error is not in the last segment, up to ten 
retries are performed, but the correction code is not applied. 


For the Paging Supervisor and subsystem I/O, the ERP leaves Relocate Mode to apply 
the correction code. 


The error analysis sequence for the IBM 2314 and 2319 Direct-access Storage Facility is 
shown in Figure 80. Figure 81 shows the error analysis sequence for the IBM 2305 Fixed 

[ Head Storage, 3330 Disk Storage, and 3333 Disk Storage and Control. The meanings of 
sense bits, IOB flags, and IOB error counts for all of the direct access devices are given 
in Figure 82. More information about the individual devices can be obtained from the 
following publications: 


e IBM System/360 Component Descriptions: 2314 Direct Access Storage Facility 
and 2844 Auxiliary Storage Control, GA26-3599 


e IBM System/360 Component Descriptions: 2835 Storage Control and 2305 
Fixed Head Storage, GA26-1589 


e Reference Manual for 3830 Storage Control and 3330 Disk Storage, 


GA26-1592 | ) 


e Reference Manual for 3333 Disk Storage and Control, GA26-1615 
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Status Sense 
Priority Bit Byte Bit Condition Pointer 
I » 45 Channel Control Check ERNT 
2 46 Interface Control Check ERNT 
3 44 Channel Data Check ERNT 
4 0 3 Equipment Check ERNT 
5 l 4 No Record Found ERNT 
6 0 7 Seek Check ERNT 
7 0 l Intervention Required ERNT 
8 0 2 Bus-Out Check ERNT 
9 0 4 Data Check ERNT 
10 0 3 Overrun ERNT 
11 1 6 Missing Address Markers ERNT 
12 0 0 Command Reject ERNT 
13 0 6 Track Condition Check ERNT 
14 | | Track Overrun ERNT 
15 I Z End of Cylinder ERNT 
16 1 2) File Protect ERNT 
17 38 Unit Check ERNT 
18 47 Chaining Check ERNT 
19 42 Program Check ERNT 
20 43 Protection Check ERNT 
21 39 Unit Exception ERNT 
22 4] Incorrect Length ERNT 


IEC23XXF logs statistics in the System Data Recording work area. 
Figure 80. 2314 and 2319 Error Analysis Sequence (Module IEC23XXF) 


Sense Byte 0 Meanings and Actions Taken 


Bit 0: Command Reject 
When this bit and bit 5 of sense byte 1 (File Protected) are set, the write inhibit 
portion of the file mask has been violated. 


When this bit and bit 3 of byte 1 (Invalid Command Sequence) are set, one of the 
following has occurred: 


e A Write command was not preceded by the necessary Search or Write command. 


e A Set File Mask, Reserve, or Release command has been issued in a chain where a 
previous Set File Mask command was given. 


e Head switching is being attempted in a command chain not containing a previous 
seek. 


e Space count has been chained from a Write command. 


e A formatting command is being attempted after record O on a defective track or 
following a record which is flagged as an overflow record. 


When this bit and bit 7 of byte 0 (seek check) are set, the 2841 detected an invalid 
seek address or was given a seek address consisting of fewer than six bytes. A seek is 
not.initiated. 
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Status Sense 


Priority Bit Byte Bit Condition Pointer 
l 45 Channel Control Check ERNT 
Z 46 Interface Control Check ERNT 
3 44 Channel Data Check ERNT 
4 47 Chaining Check ERNT 
5 1 0 Permanent Error ERNT 
6 0 3 Equipment Check ERNT 
7 0 2 Bus-Out Check ERNT 
8 0 1 Intervention Required ERNT 
9 0 0 Command Reject ERNT 
10 1 4 No Record Found ERNT 
11 0 5 Overrun ERNT 
12 1 1 Invalid Track Format — ERNT 
13 0 4 Data Check ERNT 
14 | Z End of Cylinder ERNT 
15 1 5 File Protect ERNT 
16 I i Overflow ERNT 
17 38 Unit Check ERNT 
18 42 Program Check ERNT 
19 43 Protection Check ERNT 
20 39 Unit Exception ERNT 
21 4) Incorrect Length ERNT 


IEC23XXF logs statistics in the System Data Recording work area. 
Figure 81. 2305, 3330, and 3333 Error Analysis Sequence (Modyle IEC23XXF) 





When the ‘command reject’ bit is on and the File Protected, Invalid Command 
Sequence, or Seek Check bits mentioned above are not on, one of the following has 
occurred: 


Bit 1: 


An invalid command was given. 

An invalid file mask was given. 

The sum of a key length plus data length exceeds 216-1. 

An IPL command was given after a Set File Mask command. 


Command out has been presented in response to a request for the first byte of a 
Write Home Address CCW. 


Intervention Required 


This bit indicates that the device is not physically attached to the system, or is 
physically attached but is not available for use because the file motor is not on, a 
cover is open, etc. 


Bit 2: Bus-Out Check 
This bit is set when a parity error is detected during information transfer from the 
channel to the control unit. The check is an odd parity check which is made on 
control, write, and search operations. (Parity errors which are detected during 
command transfer result in bus-out checks and not command reject.) Ten retries are 
attempted. If the error remains uncorrected, a message is written to the operator and 
the control unit is considered inoperative. 
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Figure 82. 2305, 2314, 2319, 3330, and 3333 Sense Bits, IOB Flags, and IOB Error Counts 










Overflow 
Indicator 


Exceptional 
Condition 



















Track 
Address 
Update 






















Track 
Condition 
Flag 





Bit 3: Equipment Check 
This bit indicates a malfunctioning control unit or device. A message is written to the 
j operator. Except for 2305, 3330, and 3333, the conditions that cause this bit to be set 
are defined in sense byte 2, bits 0, 2, 4, and 5. 


Bit 4: Data Check 
This bit is set when an error is defected in the information received from the device. 
Data Check will usually occur when an attempt is made to read a record which 
| overflows a track. For 2305, 3330, and 3333, if the correctable bit (byte 2, bit 1) is 
on, the Error Correction Function is used. 
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Bit 5: Overrun 
This bit is set when a chained CCW is received too late to be properly executed or 
when channel response is too slow during data transfer. Ten retries are attempted. If 
the retries are unsuccessful the error is considered permanent and a message is written 
to the operator. An overrun condition always results in an immediate stop of data 
transmission. For Write operations, the record area is padded with zeros. 


Bit 6: Track Condition Check 
This bit is set when one of the following conditions has occurred: 





e Any single track command other than Search Home Address, Read Home Address, 
or Read Record O is executed on a defective track. 


e Any multitrack command other than Search Home Address, Read Home Address, , 
or Read Record 0 causes a switch to a defective track, or an overflow operation is 
attempted to a defective track. 


S| 


e Any multitrack command or overflow operation attempts to switch from an 
alternate, or defective track on which a read or search type command has been 
executed. 


Bit 7: Seek Check 
This bit is set when the device is unable to successfully complete a seek because: 


e The seek address is invalid. Command Reject (byte 0, bit 0) is also set. 


e The seek address consists of fewer than six bytes. Command Reject (byte 0, bit 0) 
is also Set. 


e The access mechanism has malfunctioned. 


e The last three bytes at the track’s home address are not identical to the last three 
bytes of the seek address. ) 


2400 and 3400 Tape Series Error Routines 


The IBM 2400/3400 Tape Series error routine uses two operations designed to clear or 
circumvent sections of the tape that are presumably contaminated or defective. These 
operations are (1) the tape cleaner action and (2) the erase gap action. 


The tape cleaner action is a “shoe shining”’ operation in which the tape is run back and 
forth to produce a wiping action both at the read head and at the tape cleaner blade. This 
action transfers contaminants from the read head to the tape and from the tape to the 
cleaner blade. 


If the tape is being read forward, the cleaner action consists of a backward motion 
(toward the supply reel) equal in length to five records, followed by a forward motion 
equal in length to four records, positioning the read/write head at the beginning of the 
record that was being read when the data check occurred. 


If the tape is being read backward, the cleaner action consists of a backward motion 

equal in length to four records, followed by a forward motion equal in length to five 

records, positioning the read/write head at the end of the record that was being read 7 
when the data check occurred. 


The erase gap action is performed whenever a write error is detected. It consists of 
erasing a 3-1/2 inch portion of the tape, starting at the beginning of the write area 
assumed to be defective. This action treats the error as unrecoverable; the gap is a detour 
around the defective area. 


The noise bit (byte 1, bit 0) is set if a data check occurs and: phase encoding (PE) is 
used: or non-return-to-zero-inverse (NRZI) encoding is used. If a data check occurs and ) 
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the noise bit is not set, it is assumed that the data check may have been caused by too 
short a record block. In this case, the record length is checked, and if it is less than 12 
bytes, the record block is defined as a ‘‘noise block.’’ Noise blocks are skipped and 
treated as permanent errors except when found by an integrated emulator on 7-track 
tapes; then all noise blocks are returned to the emulator for further processing. The 
DEBOFLGS field of the DEB identifies the tape as an emulator tape. 


The error routines also treat parity errors differently on 7-track tapes being read by an 
integrated emulator. Rather than being a permanent error, the parity is switched 
(DEBVMOD field of the DEB) and the block reread in the alternate parity until 10 
read-recovery sequences have been executed (40 retries) or the read is successful. After 
10 read-recovery sequences, the parity is switched back to the original parity and the 
block is reread until 10 read-recovery sequences have been executed (a permanent error) 
or the read is successful. 


When an ending status (channel end, device end, or unit check) appears in the channel 
status word, the 2400/3400 error routine increments the ‘block count’ field of the data 
control block by the amount shown in the ‘block count increment’ field of the 
input/output block (JOB). 


If an error remains uncorrected after retry attempts, or if no retries are attempted, a 
message (IEAOOOI) is written to the operator. For all error conditions except ‘command 
reject, load point, data converter check’ and ‘not capable,’ the logout flag of the IOB is 
set before entry to the I/O supervisor’s Write-to-Operator routine. This is an indication 
to the I/O supervisor’s Write-to-Operator routine to invoke the Outboard Recorder after 


Sense Applicable to: 
Byte Bit Condition Read Write Control Pointer Load! 
Channel Control Check x xX x ER2404B 4 
Interface Control Check X xX x ER2404B 4 
Unit Check xX xX X ER2404B 4 
0 3 Equipment Check »4 xX X ER2404A 4 
0 2 Bus-Out Check xX ™ x ER2404A 4 
0 | Intervention Required X Xx X ER2404A 4 
0 0 Command Reject ».4 XxX xX ER2404A 4 
0 5 Overrun x x ER2404A 4 
I 4 Load Point X X ER2404A 4 
0 4 Data Check x xX x ER2404A 4 
4 Data Security Erase » 4 ER2402A 2 
Channel Data Check x x x ER2404A 4 
0 7 Data Converter Check X ER2404A 4 
| 7 Not Capable xX ER2404A 4 
5 3 PE ID Burst Check X X ER2401A ] 
No Previous Sense Bits x x x ER2404A 4 
On 
Chaining Check xX ER2404B 
Program Check xX xX xX ER2404B 
Protection Check x ER2404B 
Incorrect Length X xX ER2404B 


1Only errors that occur during Read-opposite recovery are handled by Load 3. 


Figure 83. 2400/3400 Error Analysis Sequence (Load 1—IGEO0000I, Load 2—IGE0100I, Load 


3—IGE0200I, Load 4—IGE0300I, Load 5—IGE0400I, or Load 6—IGE09001) 
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information about outboard recording. 


The error analysis sequence for the 2400/3400 is shown in Figure 83. The meanings of 
the sense bits, JOB flags, and IOB error counts are shown in Figure 84. More 


Figure 84. 2400/3400 Sense Bits, IOB Flags, and IOB Error Counts 


information can be obtained from the following publications: 


e IBM System/360 Component Description: 2400 Series Magnetic Tape Units, 
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2803/2804 Tape Controls, and 2816 Switching Unit, Model 1, GA22-6866 


e IBM System/360 Component Description: 3803/3420 Magnetic Tape Subsystems, 
GA32-0020 


e IBM 3410/3411 Magnetic Tape Subsystem Component Summary, GA32-0015 
Sense Byte 0 Meanings and Actions Taken 


Byte 0 Bit 0: Command Reject 
This bit is set when a command is received which the device has not been designed to 
execute. The error is considered permanent. 


Byte O Bit 1: Intervention Required 
This bit indicates a not-ready condition. Actions taken depend upon whether a device 
end status was also received: 


With no device end, unit status B (sense byte 1, bit 2) is examined. If 0, the device 
is assumed not to exist and the error is considered permanent. If unit status B is 1, a 
message is given the operator. When he readies the device, the operation is 
attempted again. 


With device end, if a Rewind Unload command was the last command executed, a 
successful completion is assumed and processing continues. Otherwise, the 
condition is ignored and the scan of sense bits is continued. 


Byte O Bit 2: Bus-Out Check 
This bit is set when even parity appears on the information bus lines from the channel 
to the control unit. The command is attempted again. The tape is first repositioned if 
the bus-out check occurred during a write operation. 


Byte O Bit 3: Equipment Check 
This bit is set when a unit fails to respond to a set read or a set write status when 
instructed, or becomes not ready during execution of a tape motion operation. The 
error is considered permanent. 


Byte O Bit 4: Data Check 
During a read or read backward operation: If the noise bit (byte 1, bit 0) is off and 
the blocksize is less than 12 bytes, the noise block flag in the statistics update mask is 
set and regular operation is resumed with the next block (except when 7-track tapes 
are being read by an integrated emulator, in which case the noise block is passed back 
to the emulator). 


If the noise bit is off, but the blocksize is 12 bytes or greater, or if noise bit is on, a 
read recovery sequence is initiated. This sequence consists of the following steps: 


1. Reposition the tape. 


2. Issue the Track-in-Error command to send error information (byte 2, bit 7) to the 
tape control unit. 


3. Re-read the tape. If error persists, post (or repost) the applicable flag bit 
(representing a temporary ‘read’ error) in temporary storage. 


4. Repeat steps one through three for a total of four rereads unless a good read is 
obtained. 


5. Perform a tape cleaner action and increment the temporary cleaner action counter 
in the Volume Statistics Table. 


A total of ten read recovery sequences can be initiated. If the error is not cleared by 
that time, a read-opposite recovery sequence is initiated, provided that none of the 
following conditions exists: 


e Data chaining is being performed. 
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e Data conversion mode and 7-track tape are being used. 


e The original CCW count is less than the physical block size on the tape. 





e “Suppress data transfer’’ is specified in the original CCW. 


During a write or write tape mark operation: reposition the tape, issue an erase gap, 
issue a mode set (if 7-track), and reissue the command. 


3400 write: repeat this procedure until successful or until 14 retries have been 
attempted. If the error persists after 14 retries, go to step 1 below. 


2400 write: (2400/3420 write tapemark) repeat this procedure until successful or 
until 15 retries have been attempted. If the error persists after 15 retries, go to step 
2 below. 


Step 1. Change the failing write CCW to a “‘loop-write-to-read”” CCW. The write 

CCW must not be a command or data chained from or to any of the CCWs in the ? 
original failing CCW chain. After the loop-write-to-read has been completed, the 

failing write CCW is issued to complete the fifteenth retry. 


Step 2. Provide an operator message, post completed with error condition, and exit to 
operating system. 


During an ERG: reissue the command. Repeat this procedure until 3 retries have been 
attempted. If the error persists, provide an operator message, post completed with 
error condition, and exit to the operating system. 


Byte 0 Bit 5: Overrun 
This bit is set when service is requested but data cannot be transferred during a read, 
write, or read backward operation. Five retries are attempted. Before each retry, the 
tape is repositioned. Note: A data check during overrun suppresses the overrun 


indication. ) 


Byte 0 Bit 6: Word Count Zero 
This bit is set during a write operation if transfer of data is prevented before the first 
byte is written. This indicator is ignored. 


Byte 0 Bit 7: Data Converter Check 
This bit is set when an error occurs during operation of the data conversion feature. 
The error is considered permanent. 


Other Actions Taken 


Byte 1 Bit 7: Not Capable 
Set on some models when density handling features are not compatible with actual 
tapedensity. No retries are attempted. 


Byte 5 Bit 3: Phase Encoding ID Burst Check 
Reposition to load point with a Rewind command and reissue the command. Repeat 
this procedure until successful, or until 14 retries have been attempted. A 
Loop-write-to-read command is issued and the fifteenth write retry is issued. 


Byte 7 Bit 4: Data Security Erase Error ¢ 
Print a message to the operator and record as a permanent error. 


Unexpected Device End 
Print a message to the operator and reissue the command. 


Channel Data Check 
This status bit is set when a channel detects a parity error in the information 
transferred to or from virtual storage during an I/O operation. Five retries are 
attempted. The tape is repositioned before each retry of a read or write operation. oe 


144 OS/VS2 I/O Supervisor Logic 


Chaining Check 
This status bit is set when channel overrun occurs during data chaining on read 
operations. Five retries are attempted. The tape is repositioned before each retry. 


Interface Control Check 

Channel Control Check 
An interface control check is caused by an invalid signal on the I/O interface; channel 
control check is caused by any machine malfunction affecting channel controls. 
Actions taken by the 2400/3400 error routine are shown below. Error recovery 
procedure interface bytes (ERPIB) are supplied by the Channel Check Handler 
routine. 


No retries are attempted when: 


ERPIB byte 4, bit 7 is on (unconditional no-retry). 


ERPIB byte 6, bit 3 or 4 or 5 is off (retry code invalid, unit status invalid, or 
command address invalid). 


ERPIB are not produced. 

ERPIB byte 7, bits 0 and 1 are both on (system reset). 

ERPIB byte 4, bit 2 is on (Test I/O with no pending interruption stored a CSW). 
ERPIB byte 4, bit 3 is on (Halt I/O stored a CSW). 

ERPIB byte 4, bits 0 and 1 are both on or both off. 

ERPIB byte 4, bit 5 is off (if unit check). 

There is a unit check and an equipment check. 


The interface control check or channel control check occurred during tape 
repositioning (unless cc = 1). 


Retries are attempted when none of the above conditions exists and ERPIB 
termination codes and retry combinations are: 


Termination code 10, retry code 010. Write command—retry once. 


Termination code 01, retry code 011 or 101. Write or 

Read command—reposition and retry once. For other commands (except Set, 
Mode, and Transfer-in-Channel) the operation is considered complete and no 
recovery is attempted. 


If the device is one of the 3400 series, retries are attempted when any of the following 
conditions exist: 


Read or Read Backward, termination code of 00, 01, or 10, and sequence code 
001. 


Write, termination code 00, 01, or 10, and sequence code 001. 
Control (Read/Write), termination code 00, 01, or 10, and sequence code 001. 


Control (Rewind/Unload/Mode Set), termination code 00, 01, or 10, and 
sequence code 001 or 010. 


Sense, termination code 00 or 01, and sequence code 001, 010, 011, or 101. 


For all other termination and sequence code combinations, the errors are not 
retriable. 


" 
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2495 Error Routine 


The IBM 2495 Tape Cartridge Reader error routine attempts recovery from channel data 


checks. The 2495 error routine also examines the error recovery procedure interface 
block to determine whether it should attempt recovery from channel control checks and 
interface control checks. 


The error analysis sequence is shown in Figure 85. The meanings of sense bits, IOB flags, 


and IOB error counts are shown in Figure 86. 


More information can be obtained from the following publication: JBM System/360 
Component Description, IBM 2495 Tape Cartridge Reader, GA27-2726 


Bit 0: Command Reject 
This bit is set when: 


An invalid command is received and the control unit is not busy. 
A Read command is received after end-of-tape is encountered. 


A Control Rewind or Control Backspace command is received when the tape is in 
the load position. 


A Control Backspace command is received immediately following a position check 
caused by another Control Backspace command. 


No retries are attempted. 


Bit 1: Intervention Required 


This bit is set when a command is received and the control unit is in the not-ready 
state because: 


The stop key was depressed. 

The hopper is empty and the end-of-file key has not been depressed. 
The power is off. 

The stacker is full. 


An auto-loader malfunction occurred. 


The requester’s RQE is queued so that when the tape drive is made ready the 
command will be reissued. 


Bit 2: Bus-Out Check 
This bit is set when a command with even parity appears on a bus-out operation. If 
the bit is set during initial selection, the operation is retried once. On the second 
occurrence, the error is considered permanent. 


Bit 3: Equipment Check 
This bit is set when: 


e The leader is disconnected. 


e The tape is jammed. 


e The tape is not repositioned. 


e A motion detection device fails. 


The error is considered permanent. 


Bit 4: Data Check 
This bit is set when a byte with even parity is detected in the data register during a 
Read command. The tape is backspaced one byte and the remaining portion is read. 
The sequence is repeated up to ten times. The UCB extension is used as a work area 
for constructing a backspace CCW, a residual read CCW, and, for command chaining, 
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Interface Control Check 
Channel Data Check 
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Unit Check 
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Should Not Occur 
Equipment Check 
Bus-Out Check 
Intervention Required 
Position Check 

Data Check 

Command Reject 

None of the Above Sense Bits On 
Unit Exception 


Incorrect Length 


Figure 85. 2495 Error Analysis Sequence (Module IGE0011A) 
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Figure 86. 2495 Sense Bits, IOB Flags, and IOB Error Counts 





. 


a transfer-in-channel to the next user CCW. If the error remains after ten retries, it is 
considered permanent. 
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Bit 5: Should Not Occur 
When this bit is set, a catastrophic error is assumed. 


Bit 6: Position Check (Read Command) - 
This bit is set when a Read command causes the reading of tape past the stop code, 
beyond the end of valid data. The stop code was not detected or was ignored by the 
program. The tape is backspaced one byte and the data is reread. The sequence is 
repeated up to ten times. If the error remains, it is considered permanent. The UCB 
extension is used as a work area for constructing a backspace CCW, a residual read 
CCW, and, for command chaining, a transfer-in-channel to the next user CCW. 


Bit 6: Position Check (Control) 
This bit is set by indicate that a Control Backspace command has caused backspacing 
to the beginning of the tape. No retries are attempted. 


Bit 7: Should Not Occur 
When this bit is set, a catastrophic error is assumed. e 


2540 Error Routine 


The IBM 2540 Card Read Punch error routine attempts recovery from channel data 
checks. Read operations are retried five times; punch operations are retried once, if a 
bus-out check resulted from the channel data check. The 2540 error routine also 
examines the error recovery procedure interface block to determine whether it should 
attempt recovery from channel control checks and interface control checks. 


The error analysis sequence is shown in Figure 87. The meanings of sense bits, IOB flags, 
and IOB error counts are shown in Figure 88. More information can be obtained from 
the following publications: 


e IBM System/360 Component Description and Operating Procedures: IBM 2540 
Card Read Punch, GA21-9033 J 


e IBM 2821 Control Unit, GA24-3312 
Sense Byte 0 Meanings and Actions Taken 


Bit 0: Command Reject 
The setting of this bit indicates one of the following: 


e A Read Backward or a Write command was issued to the reader. 


e A Read Backward control other than NOP or a Read Feed and Stacker Select 
command was issued to a punch without the Punch-Feed-Read feature. 


e A Read Backward or Control command was issued to a punch with the 
Punch-Feed-Read feature. 


e An incorrect sequence of instructions was issued. 
e An invalid command was received. 
The error is considered permanent. 


Bit 1: Intervention Required 
The setting of this bit indicates a not-ready condition due to one of the following: 


e Cards are not at each station (not end-of-file for the reader). 

e The stacker is full. 

e The hopper is empty (not end-of-file for the reader). 

e The Stop key was depressed. om 


e The chipbox is full or has been removed. 


148 OS/VS2 1/O Supervisor Logic 





Priority 


Oo Co AN DO WN fh We LF — 


— od, 
—_ © 


15 


Status 
Bit 

45 

46 

47 

44 

38 


42 
43 
39 
4] 


Sense Applicable to: 
Byte’ Bit Condition Read Punch Control Pointer Load 
Channel Control Check X x x ERRS51 l 
Interface Control Check X x xX ERRS51 I 
Chaining Check x xX xX ERRS46 l 
Channel Data Check x ERRS524 l 
Unit Check x Xx X ERRS25 I 
0 5 Should Not Occur x x x ERRS46 I 
0 7 Should Not Occur x x x ERRS546 1 
0 3 Equipment Check x x ERR528 l 
0 | Intervention Required x x ERRS52 2 
0 2 Bus-Out Check x x ERRS534 2 
0 4 Data Check Xx ERR536 2 
0 0 Command Reject x x x ERR548 2 
0 6 Unusual Command x ERRS555 2 
Sequence 
Program Check x x x ERRS43 2 
Protection Check X xX x ERR543 2 
Unit Exception x ERRS43 2 
Incorrect Length x x ERRS543 2 


Figure 87. 2540 Error Analysis Sequence (Load 1-IGE0001C or Load 2-IGE0O101C) 


e There is a card jam. 


A message is given the operator, who must take action. Upon correction of the 
condition, the interrupted operation is repeated. 


Bit 2: Bus-Out Check 
This bit is set when a parity error has occurred on bus-out on a command or data byte 
(bus-out is a data transfer from the processing unit to the control unit). When this 
error is detected, no punching occurs. The operation is retried once and if the error 
occurs a second time it is considered to be permanent. 


Bit 3: Equipment Check 
This bit is set after one of the following: 


e A hole count error 

e A buffer parity error 
e A translate check 

e An address check 


The error applies to the card that preceded the one from which data was transmitted; 
it is considered permanent. If the error occurred during the processing of a Read 
command, the operation is retried five times. If the error occurred during a QSAM 
operation, one retry is attempted. 


Bit 4: Data Check 
This bit is set when an invalid card code is detected. The operation is retried five 
times. On the sixth occurrence, it is denoted as a permanent error. 


Bit 5: Should Not Occur 
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Figure 88. 2540 Sense Bits, [OB Flags, and JOB Error Counts 
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Bit 6: Unusual Command Sequence 
This bit is set when there are two consecutive reads without an intervening feed. The 
error is considered permanent. 

Bit 7: Should Not Occur 


3211 Error Routine 


The IBM 3211 Printer error routine attempts recovery from channel data checks only if 
they occur with bus-out checks. A channel data check occurring alone is not considered 
an error. 


The 3211 error routine also attempts recovery from channel control checks and interface 
control checks. 


In addition to handling the normal functions of an error recovery procedure, the 3211 
ERP compiles data for device dependent OBR records. These records are then recorded 
on SYS1.LOGREC by the recording module IGE0625F. The following information will 
be recorded: 


1. FCB Parity Check—Carriage Control Address Register (CCAR) and the FCBID in 
the UCB 


2. PLB Parity Check—Diagnostic Check Read Data and the first 10 positions of the 
PLB 


3. UCS Parity Check—Contents of UCS buffer and the UCSID in the UCB 


See OS/VS SYS1.LOGREC Error Recording Logic for more information about the 
SYS1.LOGREC data set recording. 


The error recovery procedure for the 3211 Printer is shown in Figure 89. The meanings 
of sense bits, IOB flags and IOB error counts are shown in Figure 90. 
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Status Sense jak 


Priority Bit Byte Bit Condition . Pointer 
1 45 Channel Control Check ERRO31 
1 46 Interface Control Check ‘ERRO31 
2 47 Chaining Check ERRO70 
3 38 Unit Check ERRO040 
4 l 5 Command Suppress ERROSOA 
5 0 3 Equipment Check ERRO51 
6 0 2 Bus-Out Check ERRO52 
7 0 4 Data Check ERROSSE 
8 0 5 Buffer Parity Check ERRO53 
9 0 0 Command Reject ERRO71 
10 0 6 Load. Check ERRO70 
11 0 1 Intervention Required ERROS5 
12 0 7 Channel 9 ERRO64A 
13 44 Channel Data Check ERRO61 
14 42 Program Check ERR062 
15 43 Protection Check ERRO62 
16 . Al Incorrect Length ERRO63 
17 39 Unit Exception ERR064 


Figure 89. 3211 Error Analysis Sequence (Module IGEOOOOF) 





More information can be obtained from the following publication: JBM 3211 Printer 


and 3811 Control Unit Component Description, GA24-5343. 
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Figure 90. 3211 Sense Bits, IOB Flags, and IOB Error Counts 
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Sense Byte 0 Meanings and Actions Taken 


Bit 0: Command Reject ’ 
This bit is set during Initial Selection when a command other than those defined for J 


the printer is given. The error is considered permanent. 


Bit 1: Intervention Required 
This bit indicates a not-ready condition due to one of the following: 


e Platen failure 
e Ribbon motion or ribbon skew 


e Jammed or torn forms 


we 


e Carriage Stop-Release Off 
e Interlock condition a 


An ‘Intervention Required’ message is issued for the operator; when the condition is 
corrected the last operation is repeated. If this occurs with channel 9 (bit 7) the 
message is given to the operator, but the error is handled as a channel 9 condition. 
The operator has the option of forcing a permanent error by pressing the Cancel 
button on the 3211. 


Bit 2: Bus-Out Check 
This results when the control unit receives a data byte or a command byte with invalid 
parity. The operation is retried once in a non-multiple console support system and 5 
times in an MCS system. 


Bit 3: Equipment Check 
This bit indicates a malfunction that affects the operation in process. The specific 
condition will be indicated by a bit in byte 1. ) 


Bit 4: Data Check 
This bit signifies that there is an incomparable code in the UCSB or in the FCB. An 
‘Intervention Required’ message will be written to the operator and when the 
condition is corrected the previous operation will be retried. The operator will have 
the option of causing a permanent error by pressing the Cancel button on the 3211. 


Bit 5: Buffer Parity Check 
This bit indicates invalid parity in the UCSB or FCB. The error is considered 
permanent. 


Bit 6: Load Check 
This bit is given for a load UCSB or load FCB command when the load was invalid. 
The error is considered permanent. 


Bit 7: A channel 9 code was sensed in the FCB during a carriage motion. 
Sense Byte 1 Meanings od 


Bit 0: Command Retry—This indicates a parity error in the print line buffer. The error is 
considered permanent. In a systern with MCS the error is retried 5 times before it is e 
considered permanent. 


Bit 1: Print Check—Indicates the line in process may contain one or more print errors. 
Bit 2: Print Quality—Indicates a machine failure that could affect print quality. 


Bit 3: Line Position—Indicates that the previous line or next line to be printed may be in 
the wrong place. 


The last three conditions will result in an ‘Intervention Required’ message to the ) 
operator. When the condition is corrected the last operation is repeated. The operator 
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will have the option to cause a permanent error by pressing the Cancel button on the 
3211. 


Bit 6: Mechanical Motion—Signifies that the command in process cannot be completed 
and the results are unpredictable due to hardware failure. The error is considered 
permanent. 


If bit 3 of byte O is set and no bits in byte 1 are set, a sync check or train overload exists. 
These errors are considered permanent. 


3505 and 3525 Error Routines 





Priority 


Oo Oo nN HR vA bh WY WN 


ee 
oOo co NN DK OH F&F WY NY — CS 


20 


Status 
Bit 
45 
46 
44 
32 
33 
34 
38 


47 
42 
43 
39 
41 


The error routine for the IBM 3505 Card Reader and IBM 3525 Card Punch with Read 
and Punch features attempts recovery from I/O errors that cause an interruption. The 
condition causing the interruption is indicated in the channel status word (CSW). If the 
unit check (bit 38) is present in the CSW, a sense command is performed to obtain 
further information about the error interrupt. The status byte and sense byte 0 provide 
information and reasons for a unit check detected in the last operation. Sense byte 1 
defines the ERP actions required for the unit check. 


The error analysis sequence is shown in Figure 91. The meanings of the sense bits, IOB 
flags, and IOB error counts are shown in Figure 92. More information can be obtained 
from IBM 3505 Card Read and IBM 3525 Card Punch Subsystem, GA21-9124. 


Sense Applicable to: 
Byte Bit Condition Read Punch Printer Control Pointer 
Channel Control Check X xX xX xX ERROO1 
Interface Control Check X x Xx xX ERRO11 
Channel Data Check xX », 4 xX ERRO12 
Should Not Occur xX xX xX xX EXIT12 
Should Not Occur x x xX xX EXIT12 
Should Not Occur xX x xX x EXIT12 
Unit Check xX xX x xX SENSEO 
0 5 Should Not Occur > 4 > 4 xX xX EXIT12 
0 7 Permanent Error (Key) X xX x xX EXIT22 
0 3 Equipment Check xX x xX ERROO2 
0 6 Abnormal Format Reset X SENSE1 
0 1 Intervention Required X xX xX xX ERRO03 
0 2 Bus-Out Check xX x » 4 x SENSE! 
0 4 Data Check > 4 SENSE1 
0 0 Command Reject X xX xX x SENSE1 
Chaining Check Xx EXIT12 
Program Check X xX xX ERROO4 
Protection Check XxX xX Xx x ERRO004 
Unit Exception X ERROO4 
Incorrect Length X X ERR004 


Figure 91. 3505/3525 Error Analysis Sequence (Module IGE0001A) 
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vs #2". . Sense Byte 0 Meanings and Actions Taken = 


Bit 0: Command Reject | - . . i 
¢- This bit is ’sét' on for invalid commands such‘as‘read ‘backwards and for commands for 
ors ee "4 aningtalled featurés: The error is considered a permanent condition. 


t 
¢ 


Bit 1: Intervention Required 
vs >. a #Phis bit is set on for a hopper thisféed, hopper jam, corneritig station misfeed, Read 
station check, transport jam, and normal user occurrences such as hopper empty, 
joggler open, stacker full, stop key depressed, or covers open. 


ei 


Recovery from this error is possible as defined by ‘recovery indica ators: on’ ‘thie mach find. 
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Figure 92. eo0e2 Bek Sense Bits, IOB Flags, and IOB Error Counts «- ~ 


“Bit 2: Bus- Out Check 
This results in a bad parity on bus- out during initial selection, The error is considered 
a permanent condition only after the second: try. 


a 
Bit 3: Equipment Check 
This bit is turnéd on for‘errors due to data compare’ check, emitter check, and CU 
‘2. *  internal-parity check detected between IS’ and CE: ° ‘ 
A recovery can be made as defined by the e récovery indicators on the machine. 
"Bit 4: Data Check | jal 
-' “This results when an invalid EBCDIC catd ‘code'is‘found when Data Mode 1 is read. 
fowa Recovery can be made as defined by recovery indicators on the machine. 
Bit 5: Not Used : 
”” Bit 6: Abnormal Format Reset _ a ; ) 


a - oan . . = sate te sem ee 
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Bit 7: Permanent Error (Error Bypass Key) 
This results when the operator presses the Error Bypass Key rather than performing 
recovery assistance. The error is considered a permanent condition. 

Sense Byte 1 Meanings 


Bit 0: Permanent Error 
This bit directs the ERP to post a permanent error condition and proceed with 
appropriate disposition of the condition. It is set only with sense byte 0, bit 0 or bit 1. 


Bit 1: Automatic Retry 
This results in retrying the failing CCW once. If successful, normal program execution 
continues. If unsuccessful, a permanent error condition is posted and the procedure is 
continued with the appropriate disposition of the condition. This occurs only with 
sense byte 0, bits 2 and 3. 


Bit 2: Motion Malfunction 
This bit is turned on with Intervention Required when the cause is other than a normal 
user occurrence. It is set only with sense byte 0, bit 1. This bit is not required by the 
ERP to effect recovery but is included to facilitate the measurement of SSIs. 


Bit 3: Retry After Intervention Required Complete 
After a normal not-ready to ready Device End, the failing CCW is reissued. This 
occurs only with sense byte 0, bits 1,3, 4, and 6. 


Bits 4-7: Not Used. 


Sense Byte 2 Meanings 

This sense byte is for diagnostic purposes only. It defines the first error in the 3505 or 
3525 and also serves as a pointer to the appropriate maintenance documentation. 
Sense Byte 3 Meanings 

This sense byte is for diagnostic purposes only. It serves to further resolve a limited 
group of errors. 

Channel Checks 


Recovery from channel errors (channel control check, interface control check, and 
channel data check) is as follows: 


If Selective Reset or Interface Disconnect was given between Initial Selection and 
Channel End, reissue the command to the 3505 or 3525. 
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GLOSSARY OF TERMS, ACRONYMS, AND 


ABBREVIATIONS 


The following list of terms are defined as they are used in this 
publication. Acronyms and abbreviations with their meanings 
are also listed in alphabetical sequence with the list of terms. 
If you do not find the term you are looking for, refer to the 
index or tothe IBM Data Processing Glossary, GC20-1699. 


access method: Any of the data management techniques 
available to the user for transferring data between real 
storage and an input/output device. 


address translation: The process of changing the address of 
a data item or an instruction from its virtual address to its 
real storage address. See also dynamic address translation. 


allocate: To assign a resource for use in performing a 
specific task. 


alternate path retry (APR): A facility that allows an [/O 
operation that has developed an error to be retried on 
another channel assigned to the device performing the I/O 
operation. APR also provides the capability to establish other 
paths to an online or offline device. 


alternate track: For direct-access devices, a track designated 
to contain data in place of a defective primary track. 


APR: Alternate path retry. 


ASCII: American National Standard Code for Information 
Interchange. 


asynchronous: Without regular time relationship; 
unexpected or unpredictable with respect to the execution of 
a program’s instructions. 


automatic priority group: A group of tasks at a single 
priority level that are dispatched according to a special 
algorithm that attempts to provide optimum use of CPU and 
1/O resources by these tasks. See also dynamic dispatching. 


available page queue: A queue of the pages whose real 
storage is currently available for allocation to any task. 


AVT: Appendage vector table. 

BEBLK: Beginning-end block. 

BSAM: Basic sequential access method. 
BTAM: Basic teleprocessing access method. 


buffer: An area of storage that is temporarily reserved for 
use in performing an input/output operation, into which data 
is read or from which data is written. Synonymous with I/O 
area. 


burst mode: A means of transferring data to or from a 
particular I/O device on either the multiplexer or selector 
channel. All channel controls are monopolized for the 
duration of data transfer. 


byte mode: See multiplex mode. 
CAW: Channel address word. 

CC: Condition code; chain command. 
CCC: Channel control check. 

CCH: Channel check handler. 
CCW: Channel command word. 


CCW translation: See channel program translation. 
CD: Chain data. 

CE: Channel end. 

CEB: Channel error block. 


channel: A hardware device that connects the CPU and real 
storage with the I/O control units. 


channel address word (CAW): A word in real storage that 
specifies the location in real storage where a channel program 
begins. 


channel check handler (CCH): A feature that, when a 
channel error occurs, records information about the error and 
issues a message to the operator. 


channel command: An instruction that directs a channel, 
control unit, or device to perform an operation or set of 
operations. 


channel command word (CCW): A doubleword at the 
location in real storage specified by the channel address 
word. One or more CCWs make up the channel program that 
directs channel operations. 


channel program: One or more channel command words 
that control a specific sequence of channel operations. 
Execution of the specific sequence is initiated by a single start 
1/O instruction. 


channel program translation: In a channel program, 
replacement by software of virtual addresses with real 
addresses. 


channel status word (CSW): A doubleword in real storage 
that provides information about the termination of I/O 
operations. 


control block: A storage area used by an operating system to 
hold control information. 


control program: A program that is designed to schedule 
and supervise the performance of data processing work by a 
computing system. 


CPU: Central processing unit. 

CRC: Cyclic redundancy check. 
CSW: Channel status word. 

CUA: Channel and unit address. 
CVT: Communications vector table. 
DASD: Direct-access storage device. 
DAT: Dynamic address translation. 


data set: The major unit of data storage and retrieval in an 
operating system, consisting of a collection of data in one of 
several prescribed arrangements and described by control 
information to which the system has access. 


DAVV: Direct-access volume verification. 
DCB: Data control block. 

DDR: Dynamic device reconfiguration. 
DEB: Data extent block. 
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DEC: Decimal. arr 


demand paging: Transfer of a page from external page 
storage to real storage at the time it is needed for execution. 


device number: A part of an external page address that 
refers to a particular paging device; together with a group 
number and a slot number, it identifies the location of a page 
in external page storage. : 


DIDOCS: Device independent display operator’siconsote 
support. 


direct access: Retrieval or storage of data by a reference to 


its location ona volume, rather than relative to the previously 


retrieved or stored data. 

direct-access storage device (DASD): A device in 
which the access time is effectively independent of the 
location of the data. 


disabled page fault: A page fault that occurs when I/O and | 


external interruptions are disallowed by the CPU. 


disk storage: Storage on direct-access devices that record 
data magnetically on rotating disks. 


drum storage: A direct-access storage device which records 
data magnetically on a rotating cylinder. 


DSCB: Data set control.block. 
DSS: Dynamic support system. 


dynamic address translation (DAT): The change of a _ 
virtual storage address to a real storage address during 
execution of an instruction. See also address translation. 


dynamic dispatching: A facility that assigns priorities to. 


tasks within an automatic priority group, to Provide, optimum 


use of CPU and V/ ‘oO resources. : 


dynamic support system (DSS): An interactive dceauens 
facility that allows authorized maintenance personnelto | __ 
monitor. and analyze ¢ events and alfer data. iad 


EBCDIC: Extended aneveconed decane isrehanee code. 
ECB: Event control block: - 
ECF: Error correction function. 


enabled page f ault: A page fault that ‘ occurs when WV 0 and 
external interruptions are allowed by the CPU. 


EOD: End-of-day. 


EOF: End-of-file. | : : 


EOV: End-of-volume. 

ERG: Error record gap. 

ERP: Error recovery procedure. | 
ERPIB: Error recovery procedure interface block. i 7 
ESV: Error statistics by volume. 

EVA: Error volume analysis. | 

EXCP: Execute'channel cera 


EXCPVR: Execute channel progtam virtual equal real. An 
1/O request issued from'a Virtual region whose ‘channel | 
program contains real addresses. This channel program ~ 
does not require translation by IOS. 


external page address: An address that identifies the _. 
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is lécation of a.pagé, in | apage: data ‘set. “The address consists of, a 


relative device number, a relative group number, and a. 
relative slot number. oes Bese? 


external page storage: The portion of auxiliary storage that 
is used to contain pages. 


external page table (XPT): An extension of a page table 
that identifies the location on external Page storage of each 
page in the page table. 


external storage: Data storage other. than real.storage: for 
example, storage on magnetic tape or direct-access devices. _ 


FIFO: First-in, first-out. 
fixed: Not capable of being paged out. 


fixed page: A page in real storage that is not to be paged 
out. 


FLIH: First level interuption handler. 
frame: See page frame. 


frame number: The part of a real storage address needed to 
refer to a frame. See also page number and segment number. 


frame table: See page frame table. 


frame table entry (FTE): An entry in the page frame table 
that describes how a frame is being used. 


FREELIST: A chain of unassigned RQEs. 
FTE: Frame table entry. 
group: See slot group. 


group number: A part of an external page address that refers 
to a slot group; together with a device number and a slot 
number, it identifies the location of a page in emetne page 
storage. : 


GTF: Generalized trace facility. 

HA: Home address. 

HEX: Hexadecimal. 

HIO: Halt input/output. sae? ag. PRICE 
HIPO: Hierarchy ‘iputeprodess Oulpul . 


hold page queue: A queue to which pages in real storage are 
initially assigned through operations such ‘as page-in or page’ 
reclamation. See also available page queue. 


IAL: Indirect address list. 
ICC: Interface control check. 
ILC: Instruction length code. 


input / output: A general term for the equipment used to 
communicate with a computer, commonly called 1/O. The 
data involved in such communication. 


input-output error: A general term used to denote any of 
the conditions that would preclude normal (or successful) 
completion of an I/O operation. Input-output errors are 
generally a result of malfunctioning input/output devices. / 


intercepted I/O request: A request for I/O activity on 
which processing has been suspended so that an I/O error 
routine could be used to process an error that occurred after 
channel end for the last activity on the needed device. 


invalid page: A page that cannot be directly addressed by the 
dynamic address translation feature of the central processing. 
unit. 








I/O: Input/output. 

IOB: Input/output block. 

IOS: Input/output supervisor. 

IPL: Initial program loading. 

IRB: Interruption request block. 

job pack area (JPA): See region job pack area. 
JPA: Job pack area. 

LCH: Logical channel. 


link pack area (LPA): An area of virtual storage containing 
selected reenterable and serially reusable routines that are 
loaded at IPL time and can be used concurrently by all tasks 
in the system. 


link pack area directory: A directory that contains an entry 
for each entry point in link pack area modules. 


link pack area library: A partitioned data set that contains 
the modules specified to be in the link pack area. 


link pack area queue: A queue that contains a contents 
directory entry for each link pack area module currently in 
use, for each module in the link pack update area, and for 
each module in the fixed link pack area. 


link pack update area: An area in virtual storage 
containing modules that are additions to replacements for 
link pack area modules for the current IPL. 


local system queue area (LSQA): One or more 
segments associated with each virtual storage region that 
contains job-related system control blocks. 


lock/unlock facility: A supervisor facility that controls the 
execution of instruction strings when a disabled page fault 
occurs. 


logical channel: The set of all physical channels by which a 
device may be reached. 


LPA: Link pack area. 

LSQA: Local system queue area. 
MCH: Machine check handler. 
NIP: Nucleus initialization program. 


nondynamic area: The area of virtual storage occupied by 
the resident portion of the control program (the nucleus and 
the link pack area). Contrast with dynamic area. 


nonpageable dynamic area: An area of virtual storage 
whose virtual addresses are identical to real addresses; it is 
used for programs or parts of programs that are not to be 
paged during execution. 


nonpageable region: A subdivision of the nonpageable 

dynamic area that is allocated to a job step or system task 
that is not to be paged during execution. In a nonpageable 
region, each virtual address is identical to its real address. 


NRZI: Non-return-to-zero-inverse encoding. 
OBR: Outboard recorder; outboard recording. 
OLTEP: Online Test Executive Program. 


page: A fixed-length block of instructions, data, or both, that 
can be transferred between real storage and external page 
storage. 


page fault: A program interruption that occurs when a page 


marked “not in real storage” is referred to by an active page. 
Synonymous with page translation exception. 


page fixing: Marking a page as nonpageable so that it 
remains in real storage. 


page frame: A block of real storage that can contain a page. 


page frame table: A table that contains an entry for each 
frame. Each frame table entry describes how the frame is 
being used. 


page-in: The process of transferring a page from external 
page storage to real storage. 


page-out: The process of transferring a page from real 
storage to external page storage. 


paging: The process of transferring pages between real 
storage and external page storage. 


paging device: A direct-access storage device on which a 
page data set (and possibly other data sets) are stored. 


paging supervisor: A part of the supervisor that allocates 
and releases real storage space (page frames) for pages, and 
initiated page-in and page-out operations. 


PCI: Program controlled interruption. 
PCRS: Program check recovery subroutine. 
PCU: Primary control unit. 


permanent error: An I/O error that either cannot be 
corrected or remains uncorrected after error recovery 
procedures have been used. 


PGFX: Page fix. 
PL/I: Programming Language I. 


primary paging device: An auxiliary storage device that is 
used in preference to secondary paging devices for paging 
operations. Portions of a primary paging device can be used 
for purposes other than paging operations. 


processing program: Any program capable of operating in 
the problem program mode. This included IBM-distributed 
language processors, application programs, service and utility 
programs, and user-written programs. 


PSA: Prefixed storage area. 
PSW: Program status word. 
QSAM: Queued sequential access method. 


quick cell: A reserved space in the system queue area or a 
local system queue area that can be used to reduce that time 
required to allocate space for a control block. 


real storage: The storage from which the central processing 
unit can directly obtain instructions and data, and to which it 
can directly return results. 


reference bit: A bit associated with a page in real storage; 
the reference bit is turned ‘‘ON” by hardware whenever the 
associated page in real storage is referred to (read or stored 
into). There is a reference bit in each of two storage key areas 
associated with each page frame. 


region: See virtual storage region. 


region job pack area (JPA): An area in a virtual storage 
region that contains modules that are not in the link pack 
area but are needed for the execution of jobs. 


relocate hardware: See dynamic address translation. 
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RQE: Request queue element. 
RO: Record zero. 


SAVECCW: Pointer to an address of the user’s channel 
program. 


SCU: Secondary control unit. 
SER: System environment recording. 


secondary paging device: An auxiliary storage device that 
is not used for paging operations until the available space on 
primary paging devices falls below a specified minimum. 
Portions of a secondary paging device can be used for 
purposes other than paging operations. 


segment: A continuous 64K area of virtual storage, which ts 
allocated to a job or system task. 


segment table entry (STE): An entry in the segment table 
that indicates the length, location, and availability of a 
corresponding page table. 


segment translation exception: A program 
interruption that occurs when a virtual address cannot be 
translated by the hardware because the invalid bit in the 
segment table entry for that address is set. See also page 
translation exception, translation specification exception. 


SIO: Start input/output. 
SIRB: System interruption request block. 
SLI: Suppress length indication. 


Slot: A continuous area on a paging device in which a page 
can be stored. 


slot group: A set of slots on one or more tracks within a 
cylinder on a paging device. 


slot number: A part of an external page address that refers 
to a slot; together with a device number and a group number, 
it identifies the location of a page in external page storage. 


SMF: System management facilities. 
SQA: System queue area. 
STE: System table entry. 


supervisor call (SVC): An instruction which causes an SVC 


interruption in the hardware to give control to a control 
program routine (called an SVC routine) for some specific 
action, such as reassigning parts of real storage or retrieving 
data from an I/O device. 


supervisor lock: An indicator used to inhibit entry to 
disabled code while a disabled page fault is being resolved. 


SVC: Supervisor call. 

TCB: Task control block. 
TCH: Test channel. 

TIC: Transfer in channel. 

TIE: Track in error. 

TIOT: Task input/output table. 
TP: Teleprocessing. 


track address: In direct-access devices, an address made up 
of a cylinder number and a read-write head number. Every 
track of a direct-access device has a unique track address. 
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translation specification exception: <A 

program interruption that occurs when a page table entry, 
segment table entry, or the control register pointing to the 
segment table contains information in an invalid format. See 
also page translation exception, segment translation 
exception. 


UCS: Universal character set. 
UR: Unit record. 


virtual address: An address that refers to virtual storage and 
must, therefore, be translated into a real storage address 
when it is used. 


virtual equals real (V=R) storage: An area of virtual 
storage that has the same range of addresses as real storage 
and is used for a program or part of a program that cannot be 
paged during execution. 


virtual storage: Addressable space that appears to the user 
as real storage, from which instructions and data are mapped 
into real storage locations. The size of virtual storage is 
limited by the addressing scheme of the computing system 
and by the amount of auxiliary storage available, rather than 
by the actual number of real storage locations. 


virtual storage region: A subdivision of the dynamic area 
that is allocated (in segment-size blocks) to a job step ora 
system task. 


VS: Virtual storage. 
WTO: Write-to-operator. 
XPT: External page table. 





INDEX 


Indexes to program logic manuals are consolidated in the 
publication OS/VS Master Index of Logic, GY28-0603. For 
additional information about any subject listed below, refer 
to other publications listed for the same subject in the master 
index. 


ABEND routine 17, 45 
abnormal end appendage 
described 47 
in method of operation diagram 23, 26, 39 
ABTERM interface routine 63 
alternate path retry 
in module directory 61 
in routine directory 63 
selective retry 105 
vary path 105 
VARY PATH command 105 
alternate path table 
data area layout 67 
in data area directory 54 
AMDPRDMP 94 
appendage vector table (AVT) 68 
appendages 
abnormal end 
described 47 
in method of operation diagram 26 
channel end 47 
end-of-extent 47 
page fix 
in method of operation diagram 18,28 
in routine directory 63 
user’s 28 
program controlled interrupt 
described 5] 
in method of operation diagram 32 
start 1/O 
described 5] 
in method of operation diagram 24 
user’s ] 
vector table 68 
attention routine interface 
described 47 
in functional organization chart 49 
in module directory 61 
in routine directory 63 
AVT (appendage vector table) 68 


BEBLK (beginning-end block) 
CCW translation header BEBLK 71-73 
data area layout 68-69 
header BEBLK 71-73 
in data area directory 54 
translation header BEBLK 71-73 
beginning-end block (see BEBLK) 


CAW (channel address word) 
data area layout 69-70 
defined in glossary 157 
in data area directory 54 
in module directory 58 
initialization 24 
CCH (channel check handler) 
defined in glossary 157 
described 47 
in functional organization chart 49 
in method of organization diagram 32 
in module directory 61,62 
in routine directory 63 
interface 63 
CCW (channel command word) 
chains 3,4 
initialized 41 
when built 22 
data area layout 70 
defined in glossary 157 
described 47 
in data area directory 54 
translation 22,30,32 
translation header BEBLK 
data area layout 71-73 
in data area directory 56 
in method of operation diagram 30 
translator 
in functional organization chart 48 
in method of operation diagram 25,30-35 
in routine directory 63 
channel availability (see also alternate path) 
alternate path retry, described 105 
alternate path table 67 
channel search routine, described 47 
test channel routine 
described 51 
in routine directory 64 
channel check handler (see CCH) 
channel command word (see CCW) 
channel end appendage 
described 47 
in method of operation diagram 34,45 
channel error block table 
data area layout 73-74 
in data area directory 54 
channel program 
defined in glossary 157 
translation 
defined in glossary 157 
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explanation of 113 
PURGE routine 113 
starting I/O 113 
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I/O new PSW 61 
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terminating 6-7,12 
I/O purge routine 97 
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in module directory 60 
I/O requesters, characteristics of 4 
1/O supervisor 
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error EXCP supervisor 44-45,50 
EXCP supervisor 14,15,48 
EXCP validity check 51 
functions of 6-8 
I/O interrupt volume verification 107 
I/O purge routine 97 
OLTEP synchronizing module 115-116 
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write-to-operator 117-118 
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channel restart routine 36-37 
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error EXCP routine 44-45 
error routine interface 42-43 
EXCP supervisor 14-15 
get request element routine 18-19 
I/O interruption supervisor 32-35 
I/O supervisor 12-13 
page fix routine 28-29 
post start I/O routine 26-27 
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method of operation (Continued) 
sense subroutine 40-41 
SIO subroutine 24-25 
start [/O routine for DASD 22-23 
start [/O routine for tape 20-21 
validity check routine 16-17 
miscellaneous data recording routine 50 
module directory 57-62 
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page exception handler routine 63 
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user’s 28 
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in routine directory 63 
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page supervisor 3 
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in routine directory 63 
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program check recovery subroutine (PCRS) 63,111 
program controlled interrupt appendage 51 
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program organization 
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described 96-102 
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in module directory 58,59 
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supervisor’s asynchronous exit queues 99 


supervisor’s request block queues 99 7 ) 
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RESTORE macro 100,102 


use of IOB 100 
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virtual I/O request 102 
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queuing 
scheduling I/O 6 
terminating I/O 6 
queuing methods 
FIFO 63 
ordered seek 63 
priority 63 
quiesce complete subroutine 
described 51 
in functional organization chart 49 
in module directory 61 
in routine directory 64 
quiesce I/O parameter list 99 
quiesce option 101 


register assignments 91 
request queue element (see RQE) 
RESTORE macro 100,102 
restore routine 
described 102 
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routine descriptions 47-52 
routine directory 63-64 
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building 14 
data area layout 86-87 
in data area directory 56 
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in module directory 58,62 
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scheduling I/O 86 
table 87 
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1288 123 
1403 125 
1419 128 
1443 125 
2250 133 
2260 135 
2305 139 
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SIO (see start I/O) 
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described 102 
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subroutine 
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SVC 92 104 
SVC 109 104 
SVC 114 3,12 
synchronizing module, OLTEP 115-116 
system completion codes 91-92 
system environment recording (see SER) 
supervisor 
(see also I/O supervisor and page supervisor) 
I/O 3 
page 3 


task control block (see TCB) 
TCB (task control block) 
in data area directory 56 
EXCP 104 
in module directory 59 
test channel routine 
described 51 
in functional organization chart 48 
in method of operation diagram 26 
in module directory 62 
in routine directory 64 
time sharing option (see TSO) 
trace facility, generalized 94-95 
translation header BEBLK 
data area layout 71-73 
in data area directory 56 
in method of operation diagram 30 
translator 
CCW 30-32,63 
trap routines 
described 51 
in method of operation diagram 30-31 
in module directory 61 
in routine directory 64 
TSO (time sharing option) 
TCB EXCP 104 
TCB EXCP interface routine 64 
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UCB (unit control block) 
in data area directory 56 
in data area relationships 66 
in module directory 58 
lookup table 56 
when updated 24 
unfix/FREEMAIN routine 
in method of operation diagram 35 
in routine directory 64 
unit control block (see UCB) 
unit record 
start I/O 64 
trap routine 64 
user interaction with I/O supervisor 1-3 


validating input data 14,16-17 
validity check routine 
described 52 
in functional organization chart 48 
in method of operation diagram 16-17,45 
in routine directory 64 
validity check subroutine 
described 52 
in module directory 62 
validation of data in method of operation diagram 16-17 
virtual I/O request, purging 102 
Virtual request 102 
VOLSTAT routine 
described 103 
in module directory 59 
volume statistics table 
data area layout 88-89 
in data area directory 56 
volume Verification 
for direct access 107 
in module directory 60 
VS subsystems 3 


write-to-operator error messages 117-118 
WTO (write-tc-operator) routine 
described 117-118 
in module directory 58,60,61 
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